Get balance statement

curl -G https://api.crisscross.money/v1/balances/statements \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d currency=USD

{
  "statements": [
    {
      "currency": "USD",
      "type": "deposit",
      "amount": "10000.00",
      "balanceAfter": "10000.00",
      "createdAt": "2024-04-10T14:22:00Z",
      "relatedId": "dep_123e4567-e89b-12d3-a456-426614174000"
    },
    {
      "currency": "USD",
      "type": "order_sell",
      "amount": "-2500.00",
      "balanceAfter": "7500.00",
      "createdAt": "2024-04-09T10:15:00Z",
      "relatedId": "ord_987f6543-e21b-45d3-b789-123456789abc"
    },
    {
      "currency": "USD",
      "type": "fee",
      "amount": "-15.00",
      "balanceAfter": "7485.00",
      "createdAt": "2024-04-09T10:16:00Z",
      "relatedId": null
    }
  ],
  "nextCursor": "eyJwYWdlIjoxLCJpZCI6IjY1ZjYxYjYxLTQ3YjktNDY3YS1hYjYxLTAwYjYxYjYxYjYxNiJ9",
  "hasMore": true
}

Ledger of final balance-affecting events for a given currency, most recent first. Audit and reconciliation source of truth.

Reservations are not statement entries — they are reflected in the reserved field on GET /v1/balances. Statement entries represent final fund movements only.

Authentication

AuthorizationBearer

Token obtained via the login flow.

Query parameters

currencystringRequired

ISO 4217 currency to retrieve the statement for.

typelist of enumsOptional

Filter by one or more entry types. Repeatable — e.g. ?type=deposit&type=order_sell. A filled trade generates two entries: order_sell (negative amount in the sell currency) and order_buy (positive amount in the buy currency).

createdAfterdatetimeOptional

createdBeforedatetimeOptional

limitintegerOptional1-200Defaults to 20

Maximum number of results to return. Default 20, max 200.

cursorstringOptional

Opaque cursor from nextCursor of a previous response.

Response

Statement entries.

statementslist of objects

nextCursorstring or null

Opaque cursor for the next page. null when the list is exhausted.

hasMoreboolean

Convenience flag. false when nextCursor is null.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error