Перейти к основному содержанию

​
GET /me/flow-balance

Вернуть FLOW-баланс текущего пользователя с разбивкой по источникам. Auth: требуется. 
curl https://api.agentflow.website/me/flow-balance \
  -H "Cookie: af_session=..."
Ответ 
{
  "balance": 412.6,
  "withdrawableFlow": 283.2,
  "breakdown": {
    "topUp": 50,
    "subscriptionGrant": 73.4,
    "creatorShare": 180,
    "holderRewardsTotal": 78.2,
    "freelance": 25,
    "quests": 6
  },
  "recentLedger": [
    {
      "id": "led_01HQ...",
      "delta": -0.5,
      "reason": "call",
      "refType": "agent_call",
      "refId": "call_01HQ...",
      "createdAt": "2026-04-25T11:42:00Z"
    }
  ]
}
​
balance
number
обязательно
Текущий доступный к трате FLOW-баланс.
​
withdrawableFlow
number
обязательно
Подмножество balance, доступное к выводу (исключает грант FLOW и непрошедшие clearance top-up).
​
breakdown
object
обязательно
Lifetime-итоги по источникам. Полезно для аналитики.
​
recentLedger
object[]
Последние 20 записей регистра. Для постраничной истории — эндпоинт ledger.

​
GET /ledger

Постраничная история регистра текущего пользователя. Auth: требуется. Query-параметры
​
cursor
string
Курсор пагинации.
​
reason
string
Фильтр по reason: topup, call, grant, payout, refund, quest.
​
from
string
Метка ISO 8601.
​
to
string
Метка ISO 8601.
curl "https://api.agentflow.website/ledger?reason=call&from=2026-04-01" \
  -H "Cookie: af_session=..."
Ответ 
{
  "items": [
    {
      "id": "led_01HQ...",
      "delta": -0.5,
      "reason": "call",
      "refType": "agent_call",
      "refId": "call_01HQ...",
      "metadata": { "agentSlug": "hermes-bot" },
      "createdAt": "2026-04-25T11:42:00Z"
    }
  ],
  "nextCursor": "..."
}

​
Ошибки

КодКогда
unauthenticatedНет или истекла сессионная cookie
invalid_cursorКурсор испорчен или истёк