v1

latestOpenAPI 3.0.02026-07-26117198177.4 KB

Account Connections

List transactions for an account on a connection

Returns paginated transactions for a single account belonging to this connection, read from the persisted transaction history. Run POST /transactions/sync first to populate history for a newly connected account. Pagination is opaque token (cursor) based — pass meta.next_cursor back as ?cursor to fetch the next page; null next_cursor means no more results.

get/v2/account-connections/{id}/transactions

Path parameters

idstring required

Query parameters

account_idstring uuid required

Example:27347428-643d-4bff-837f-ab209e0df987

Account id (in this API) to scope transactions to. Must belong to the connection. This is the Range account UUID, not the wallet address.

wallet_addressstring

Example:B56RWQGf9RFw7t8gxPzrRvk5VRmB5DoF94aLoJ25YtvG

Realms wallet address to fetch history for. Must be a NativeTreasury PDA or Governance PDA belonging to this connection. Required when the Realm has more than one treasury.

cursorstring

Example:eyJwYWdlVG9rZW4iOiJYWVoifQ==

Opaque cursor returned in meta.next_cursor of a previous response.

sizenumber

Example:100

Response

Example response

{
  "items": [
    {
      "id": "0x9a3f...",
      "transaction_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "account_id": "acc_abc123",
      "kind": "TRADE",
      "status": "CONFIRMED",
      "timestamp": "2026-01-15T10:00:00.000Z",
      "hash": "0xabc...",
      "network": "networks/ethereum-mainnet",
      "block_number": "21000000",
      "usd_amount": "250.50",
      "transfers": [
        {
          "direction": "IN",
          "asset": "USDC",
          "amount": "100.50",
          "usd_amount": "9.831",
          "source_address": "0xabc...",
          "destination_address": "0xdef..."
        }
      ],
      "trade": {
        "side": "BUY",
        "base_asset": "BTC",
        "base_amount": "0.01",
        "quote_asset": "USDC",
        "quote_amount": "500.0",
        "price": "50000.0",
        "fee": "0.45",
        "fee_asset": "USDC",
        "realized_pnl": "25.11"
      },
      "category": "Payroll",
      "raw": {}
    }
  ],
  "meta": {
    "next_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "previous_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "first_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "last_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "total_count": 100,
    "page_number": 1
  }
}