Account Statement

Read all balances and a paginated list of operations for a user over a window.

POST /api/account/statement

Returns the API key user's current balances on every supported network plus a paginated feed of operations (deposits, withdrawals, payouts, transfers) within a date range.

GET /api/account/statement is also accepted, with the same parameters sent as query string (?from=...&to=...&limit=50&type=payout&type=transfer).

valueInBrl and fee are decimal BRL strings. Balances are in token units.

Request

curl --request POST \
  --url https://api.hodle.com.br/api/account/statement \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "from": "2026-04-01T00:00:00Z",
    "to":   "2026-05-01T00:00:00Z",
    "limit": 50
  }'
const res = await fetch('https://api.hodle.com.br/api/account/statement', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.HODLE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    from: '2026-04-01T00:00:00Z',
    to: '2026-05-01T00:00:00Z',
    limit: 50,
  }),
})
const data = await res.json()
import os, requests

res = requests.post(
    "https://api.hodle.com.br/api/account/statement",
    headers={
        "Authorization": f"Bearer {os.environ['HODLE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "from": "2026-04-01T00:00:00Z",
        "to":   "2026-05-01T00:00:00Z",
        "limit": 50,
    },
)
data = res.json()

Parameters

FieldTypeRequiredDescription
fromstringNoISO start of window (inclusive). Defaults to 30 days ago. Max window 90 days.
tostringNoISO end of window (exclusive). Defaults to now.
limitintegerNo1–200. Default 50.
cursorstringNoContinuation token from a previous response's nextCursor.
typestring / string[]NoFilter: deposit, withdraw, payout, transfer. Send an array in POST or repeat the query parameter in GET.
subAccountIdstringNoRead the balances and operations of a subaccount under your platform.

Response

200 OK
{
  "success": true,
  "data": {
    "balances": [
      { "network": "polygon", "asset": "USDT", "amount": "182.45" },
      { "network": "base",    "asset": "USDC", "amount": "0.00"   },
      { "network": "tron",    "asset": "USDT", "amount": "0.00"   },
      { "network": "solana",  "asset": "USDC", "amount": "12.34"  }
    ],
    "subAccountId": null,
    "operations": [
      {
        "id": "op_8f3a...",
        "type": "payout",
        "status": "COMPLETED",
        "amount": "5.00",
        "asset": "USDT",
        "network": "polygon",
        "valueInBrl": "27.40",
        "fee": "1.55",
        "txHash": "0xeafe9c...",
        "endToEndId": "E12345...",
        "externalId": "your-payout-id",
        "reference": null,
        "direction": "out",
        "createdAt": "2026-04-28T23:32:10.000Z",
        "completedAt": "2026-04-28T23:33:42.000Z"
      },
      {
        "id": "op_b21f...",
        "type": "deposit",
        "status": "COMPLETED",
        "amount": "100.00",
        "asset": "USDC",
        "network": "base",
        "valueInBrl": "545.00",
        "fee": "0.00",
        "txHash": "0xa1b2...",
        "endToEndId": "E31872495...",
        "direction": "in",
        "createdAt": "2026-04-26T14:11:02.000Z",
        "completedAt": "2026-04-26T14:13:55.000Z"
      }
    ],
    "nextCursor": "c2Vla180MjkyMjEz",
    "total": 137
  }
}
FieldTypeDescription
data.balancesarrayOn-chain balances summed across the selected account’s wallets, per network and asset.
data.subAccountIdstring?The sub-account the statement was read for, or null for your own account.
data.operationsarrayOne row per operation, sorted by createdAt desc.
data.nextCursorstring?If present, pass back as cursor to fetch the next page.
data.totalintegerTotal matching operations in the window.

Operation fields

FieldTypeDescription
operation.amountstringReceived token amount when available; otherwise the BRL value as a decimal string.
operation.directionstringin for money entering the account, out for money leaving it.
operation.txHashstring?On-chain hash of the delivery: for a deposit, the transfer to your wallet.
operation.endToEndIdstring?PIX endToEndId: the payer's for a deposit, the receiver's for a payout.
operation.externalIdstring?The externalId you sent when creating the operation, to match it to your own record.

Operation types

TypeSource endpointDirection
deposit/api/deposit/assetIn
withdrawLegacy off-ramp (no longer offered)Out
payout/api/wallet/payoutOut
transfer/api/wallet/transferOut

Errors

StatusWhen
400Invalid parameters, invalid dates, a window over 90 days, or an invalid cursor.
401Missing or invalid API key.
404Account or subaccount not found under your platform.
400
{ "success": false, "error": "Window must be at most 90 days" }