Skip to content
API

Billing & balance

Requests are billed by token: (input_tokens × input_price + output_tokens × output_price) ÷ 1,000,000. Prices are in dollars per million tokens. Streaming counts the same as non-streaming. Failed requests are not charged.

Pricing

Visit the Models & pricing page to see all models and rates.

Minimum charge

Each request has a minimum charge of $0.000. Small requests are rounded up; you still only pay for tokens actually used if the total is larger.

Checking balance and usage

The console shows your current balance and per-request usage logs. You can also query the balance endpoint and download usage as CSV.

Balance endpoint

Returns the current account balance.

curl https://tokenarmy.shop/v1/balances \
  -H "Authorization: Bearer $TOKENARMY_API_KEY"

Response:

{
  "balance_usd": 123.45
}

Usage endpoint

Returns usage stats. Pass start_timestamp and end_timestamp as milliseconds since epoch. Optional: pass a key_id to filter by a specific key.

curl "https://tokenarmy.shop/v1/usage?start_timestamp=1730000000000&end_timestamp=1730086400000" \
  -H "Authorization: Bearer $TOKENARMY_API_KEY"

Response:

{
  "object": "list",
  "data": [
    {
      "timestamp": 1730000000000,
      "model": "claude-sonnet-5-5",
      "input_tokens": 1000,
      "output_tokens": 500,
      "cache_read_tokens": 0,
      "cache_write_tokens": 0,
      "status": "success",
      "cost_usd": 0.0234
    }
  ]
}