Credit & Balance Endpoints

Keep track of your Raiden Terminal API spending with two free endpoints: check the credits left on your API key before a batch, and fetch the credit price of every endpoint.

Paths are relative to https://terminal.raiden.wtf/api and every request carries your key in the X-API-Key header (see Authentication). Each call costs the credits shown next to it.

Account balance

Free balance check for the key you send: what is left on its pool, the plan and the next renewal.

• pool — the general pool, or the key’s dedicated monthly budget.
• reset_at — the next renewal; null on the free trial, which doesn’t renew.
• warning — used_50, used_80, used_95 or exhausted.

curl -s "https://terminal.raiden.wtf/api/account/balance" \
  -H "X-API-Key: $RAIDEN_KEY"

{
  "pool": "general",
  "key_id": 57,
  "remaining": 183400,
  "capacity": 200000,
  "pct_used": 8,
  "warning": null,
  "plan": "trial",
  "reset_at": null,
  "rate_limit": { "rps": 20, "burst": 40 },
  "enforced": true
}

Credit costs per endpoint

The price of every endpoint in credits. Public and free: no key needed.

routes is keyed by "METHOD /path". Each route has:

• default — the price with no query parameters.
• rule — how the parameters change it (L = the limit parameter).
• pack — priced on the parts that succeeded.

The same table is rendered on Credits per endpoint.

curl -s "https://terminal.raiden.wtf/api/credits/costs" \
  -H "X-API-Key: $RAIDEN_KEY"

{
  "version": 4,
  "cost_version": 4,
  "unit": "Credits charged per request made with an API key. The price is set by the route and its query parameters before the request runs; the response status can lower it (see status). Browsing the website is free.",
  "routes": {
    "GET /tokens": { "rule": "2 + 3*ceil(max(0, L-20)/50), L 100/500", "default": 8, "params": [{ "name": "limit", "default": 100, "max": 500 }] },
    "GET /tokens/{mint}/pack": { "rule": "ceil(40*ok/9), 0 when no part succeeds", "default": 40, "pack": true }
  }
}