Balance API

Get balances

GET /v1/balance

Returns a Balance row per currency the merchant has activity in.

Response

{
  "data": [
    {
      "currency": "TRY",
      "available": "0",
      "pending": "10395",
      "reserved": "0",
      "updatedAt": "2026-05-06T12:00:00.000Z"
    },
    {
      "currency": "USDT",
      "available": "0",
      "pending": "0",
      "reserved": "0",
      "updatedAt": "2026-05-06T11:30:00.000Z"
    }
  ]
}

All amounts are strings of BigInt minor units. Treat them as BigInt in code:

import { BigInt as B } from "node:crypto"; // or built-in BigInt
const balance = await fetch("/v1/balance", { headers }).then((r) => r.json());
const tryAvailable = B(balance.data[0].available); // 10395n

See Balance & ledger for what each bucket means.