AggreGate/Документация
aggregate.surf
docs/account

Баланс и остаток

GET /v1/me — баланс, токены в пакетах и расход за месяц по вашему API-ключу. Удобно проверять прямо из терминала, OpenCode или скрипта, не заходя в кабинет.

Через VPN или из-за границы? Переключитесь на Gateway.

Base URL
https://api.aggregate.surf/v1
GET /v1/me60 rpm

Запрос авторизуется тем же ключом sk-ag-…, что и запросы к моделям, и возвращает снимок аккаунта: остаток на балансе, остаток токенов в каждом активном пакете, расход за текущий календарный месяц (UTC) и лимиты самого ключа. Запрос бесплатный, не расходует токены; лимит — 60 запросов в минуту на ключ.

Пример

bash
curl -s https://api.aggregate.surf/v1/me \
  -H "Authorization: Bearer sk-ag-..."

Ответ

json
{
  "user": { "id": "…" },
  "api_key": {
    "id": "…", "name": "opencode", "prefix": "sk-ag-ab12",
    "monthly_token_limit": null,
    "monthly_tokens_used": 1840233,
    "last_used_at": "2026-09-23T08:12:04Z"
  },
  "balance": {
    "amount_cents": 1250, "amount": "12.50", "currency": "USD",
    "reserved_cents": 0,
    "bonus_remaining_estimate_cents": 0,
    "next_topup_needed_cents": null
  },
  "token_packages": [
    {
      "id": "…", "package_name": "Pro 50M",
      "tokens_granted": 50000000, "tokens_used": 41200000,
      "tokens_reserved": 0, "tokens_available": 8800000,
      "expires_at": "2026-10-20T00:00:00Z", "status": "active"
    }
  ],
  "usage_current_month": {
    "period_start": "2026-09-01T00:00:00Z",
    "requests": 912, "total_tokens": 48112090, "cost_usd": 61.4
  },
  "server_time": "2026-09-23T08:15:00Z"
}

Что смотреть

  • balance.amount — деньги на балансе в USD. С баланса списывается расход, когда в пакетах закончились токены.
  • token_packages[].tokens_available — сколько токенов осталось в каждом активном пакете. Когда сумма подходит к нулю, следующие запросы пойдут с баланса.
  • usage_current_month — запросы, токены (включая кэш) и стоимость по прайсу с 1-го числа текущего месяца (UTC).
  • api_key.monthly_tokens_used и monthly_token_limit — расход этого ключа за месяц и его квота (null — без ограничения).
  • Не опрашивайте чаще раза в секунду: при превышении 60 запросов в минуту API вернёт 429 с заголовком Retry-After.
AggreGate Documentation