Core Concepts

Tokens & Billing

GTM Tools is metered in tokens. One wallet pays for every server. New accounts get 100 free tokens to start.

The basics

Value
Exchange rate$1 = 100 tokens
Minimum top-up$5 (500 tokens)
Free starter balance100 tokens
ReservationCharges are reserved at request time and refunded on failure

Cost per tool

Each tool publishes its cost via get_token_balance.

Admin Tools

Every admin tool is 0 tokens — the wallet itself doesn’t consume tokens.

Socials Tools

ToolTokens
connect_linkedin, list_connected_linkedin_accounts0
get_linkedin_company_url, get_linkedin_post, get_linkedin_job, get_linkedin_company, list_linkedin_company_posts2
get_linkedin_profile4
get_linkedin_profile_url, list_user_posts, send_linkedin_message, send_linkedin_invitation, list_linkedin_conversations, list_linkedin_jobs, list_linkedin_company_posts, list_linkedin_post_reactions, list_linkedin_post_comments5
list_linkedin_saved_posts10
list_linkedin_company_employees30
list_linkedin_company_employees_posts80

Email Tools

ToolTokens
get_email5

Signals Tools

ToolTokens
detect_signal, set_signals_order, get_signals_order0
Every individual signal_* detector5

How metering works

Every request to a paid tool is intercepted before it executes:

  1. Authorize. Resolve the bearer token to an org.
  2. Reserve. Hold the tool’s token cost against the wallet.
  3. Execute. Run the tool.
  4. Settle. On success, commit the charge. On failure, refund the reservation.

If the wallet has insufficient balance, the request fails with 402 Insufficient Tokens — no detector runs, no charge applied.

Top-ups

Use buy_tokens (in admin-tools) for one-off purchases:

$curl -X POST https://api.gtm-tools.sh/api/v0/buy_tokens \
>  -H "Authorization: Bearer $GTM_TOOLS_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{"amount_usd": 25}'

Or set up set_auto_reload so the saved card is charged automatically when the balance drops below your threshold:

$curl -X POST https://api.gtm-tools.sh/api/v0/set_auto_reload \
>  -H "Authorization: Bearer $GTM_TOOLS_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{"enabled": true, "threshold_tokens": 200, "topup_usd": 50}'

Receipts

list_invoices returns invoice records for purchases and refunds:

$curl https://api.gtm-tools.sh/api/v0/list_invoices \
>  -H "Authorization: Bearer $GTM_TOOLS_API_KEY"

Next steps

Token Efficiency

Prefer cheap tools first, batch where possible, short-circuit on signal.

Admin Tools

Full reference for keys, balance, top-ups, auto-reload.