Skip to main content

​
GET /me/flow-balance

Return the current user’s FLOW balance, broken down by source. Auth: required. 
curl https://api.agentflow.website/me/flow-balance \
  -H "Cookie: af_session=..."
Response 
{
  "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
required
Current spendable FLOW balance.
​
withdrawableFlow
number
required
Subset of balance eligible for payout (excludes grant FLOW and unsettled top-ups).
​
breakdown
object
required
Lifetime totals by source. Useful for analytics.
​
recentLedger
object[]
Last 20 ledger entries. Use ledger endpoint for paginated history.

​
GET /ledger

Paginated ledger history for the current user. Auth: required. Query params
​
cursor
string
Pagination cursor.
​
reason
string
Filter by reason: topup, call, grant, payout, refund, quest.
​
from
string
ISO 8601 timestamp.
​
to
string
ISO 8601 timestamp.
curl "https://api.agentflow.website/ledger?reason=call&from=2026-04-01" \
  -H "Cookie: af_session=..."
Response 
{
  "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": "..."
}

​
Errors

CodeWhen
unauthenticatedMissing or expired session cookie
invalid_cursorCursor is malformed or expired