Get user balances

GET

/apps/{appId}/users/{userId}/balances

Authorization

appApiKey

headerx-app-api-key<token>

App-scoped API key. It is the only credential on partner-admin reads, paper-trading admin, and webhook rotate or replay. POST /bot-protection/verify requires it together with x-app-id.

Path Parameters

appId*string

userId*string

Response Body

200

application/json

response

cash*array<>

Stablecoin cash, one entry per token, with per-chain rows.

positions*array<>

Value of open positions, one entry per venue.

venueCash?array<>

Cash held inside venue accounts, separate from on-chain cash. Omitted when no such venue is available.

paper?

Paper-account summary. Present only in paper mode.

Example Request

curl -X GET 'https://api.t.sufwankhalid.com/apps/string/users/string/balances'

Example Request

curl -X GET 'https://api.t.sufwankhalid.com/apps/string/users/string/balances'

Example ResponseSchema

{
  "cash": [
    {
      "tokenSymbol": "string",
      "totalRaw": "string",
      "availableRaw": "string",
      "reservedRaw": "string",
      "decimals": 0,
      "chains": [
        {
          "chainId": 0,
          "tokenAddress": "string",
          "balanceRaw": "string",
          "heldRaw": "string",
          "availableRaw": "string",
          "decimals": 0,
          "lastSyncedAt": "string",
          "tokenSymbol": "string",
          "address": "string",
          "walletAddress": "string",
          "custodyKind": "EOA",
          "venue": "kalshi",
          "venueAccountId": "string",
          "externalAccountId": "string",
          "isFresh": true,
          "registeredByAgg": true,
          "legacyKind": "safe"
        }
      ]
    }
  ],
  "positions": [
    {
      "venue": "kalshi",
      "balance": 0,
      "costBasis": 0,
      "unrealizedPnl": 0,
      "realizedPnl": 0,
      "priceSource": "orderbook",
      "bookQuality": "healthy",
      "migrationPending": true,
      "costBasisUnknown": true,
      "realizedPnlIncomplete": true
    }
  ],
  "venueCash": [
    {
      "venue": "kalshi",
      "balanceCents": 0,
      "transferable": true,
      "executionBackend": "clearinghouse",
      "accountModel": "platform-hosted",
      "asset": "USDC",
      "decimals": 6,
      "balanceRaw": "string",
      "availableRaw": "string",
      "unmatchedExposureRaw": "string",
      "portfolioValueCents": 0,
      "updatedAt": "string"
    }
  ],
  "paper": {
    "startingBalance": 0,
    "cashBalance": 0,
    "positionsValue": 0,
    "realizedPnl": 0,
    "unrealizedPnl": 0,
    "earnings": 0
  }
}

{  "cash": [    {      "tokenSymbol": "string",      "totalRaw": "string",      "availableRaw": "string",      "reservedRaw": "string",      "decimals": 0,      "chains": [        {          "chainId": 0,          "tokenAddress": "string",          "balanceRaw": "string",          "heldRaw": "string",          "availableRaw": "string",          "decimals": 0,          "lastSyncedAt": "string",          "tokenSymbol": "string",          "address": "string",          "walletAddress": "string",          "custodyKind": "EOA",          "venue": "kalshi",          "venueAccountId": "string",          "externalAccountId": "string",          "isFresh": true,          "registeredByAgg": true,          "legacyKind": "safe"        }      ]    }  ],  "positions": [    {      "venue": "kalshi",      "balance": 0,      "costBasis": 0,      "unrealizedPnl": 0,      "realizedPnl": 0,      "priceSource": "orderbook",      "bookQuality": "healthy",      "migrationPending": true,      "costBasisUnknown": true,      "realizedPnlIncomplete": true    }  ],  "venueCash": [    {      "venue": "kalshi",      "balanceCents": 0,      "transferable": true,      "executionBackend": "clearinghouse",      "accountModel": "platform-hosted",      "asset": "USDC",      "decimals": 6,      "balanceRaw": "string",      "availableRaw": "string",      "unmatchedExposureRaw": "string",      "portfolioValueCents": 0,      "updatedAt": "string"    }  ],  "paper": {    "startingBalance": 0,    "cashBalance": 0,    "positionsValue": 0,    "realizedPnl": 0,    "unrealizedPnl": 0,    "earnings": 0  }}

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Response Body