v1

latestOpenAPI 3.0.02026-07-26117198177.4 KB

Account Connections

List transactions across all account connections in the workspace

Fans out across every connection-linked account in the caller workspace and returns the merged list of transactions, sorted newest-first, capped at size (default 5). 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. Connections whose provider does not support transactions, or that fail to fetch, are skipped.

get/v2/account-connections/transactions

Query parameters

cursorstring

Example:eyJ0aW1lc3RhbXAiOiIyMDI0LTAxLTAyVDAwOjAwOjAwLjAwMFoiLCJpZCI6IjkxIn0=

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

sizenumber

Example:5

Maximum number of transactions to return after merging and sorting newest-first across all connections.

tokensstring[]

Comma-separated asset symbols to filter by. A transaction is kept when its displayed asset matches one of these symbols (case-insensitive) — for a trade that is the base asset, otherwise the first transfer leg. Applied to the merged result.

start_timestring date-time

Example:2025-01-01T00:00:00Z

Start time (ISO 8601). Converted to Date.

end_timestring date-time

Example:2025-12-31T23:59:59Z

End time (ISO 8601). Converted to Date.

statusstring[]

Comma-separated status aliases (lowercase): 'success' (CONFIRMED), 'errored' (FAILED), 'pending' (PENDING).

min_usdnumber

Minimum USD amount (decimal). Converted to number.

max_usdnumber

Maximum USD amount (decimal). Converted to number.

string_searchstring

Example:0xabc

Case-insensitive substring search over transaction id, hash, network, asset symbols, and counterparty addresses.

account_idstring uuid

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Limit results to transactions belonging to this account (must be linked to a connection in the workspace).

group_idsstring[]

Limit results to accounts belonging to these group IDs (comma-separated UUIDs).

categoriesstring[]

Comma-separated category labels. A transaction is kept when its category matches one of these values.

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
  }
}