Sign in

v1

latestOpenAPI 3.0.02026-07-26117198177.4 KB
Token transfers

Get token transfers

Returns a list of token transfers that match the specified search term.

get/v2/transfers

Query parameters

explorerstring
Example:solana
cursorstring
Example:n0192376853
sort'usd'
Example:usd
sizenumber
Example:10
tx_hashstring
Example:0xbe667b06979c46e186cebb4ad2c6fb6af8fb034e4723518416b2e7d3aeeb4753
tx_hashesstring[]

Comma-separated list of transaction hashes to filter by

source_networksstring[]
destination_networksstring[]
networkstring
Example:cosmoshub-4

Only find transfers on one specific network

addressstring
Example:C6RarBbo5zxMzFiVhYAvbGUWiJGuVsSczawdXdGzeEoj

Only find transfers on one specific address

addressesstring
Example:C6RarBbo5zxMzFiVhYAvbGUWiJGuVsSczawdXdGzeEoj,C6RarBbo5zxMzFiVhYAvbGUWiJGuVsSczawdXdGzeEoj

Only find transfers involving this specific address as sender and reciever

search_stringstring
Example:e.g. partial address
statusstring[]

Current status(es) of the transfer, comma-separated (e.g. 'SUCCEEDED,FAILED')

bridgesstring[]

Bridges or networks used for the transfer

token_symbolsstring[]

Token symbols involved in the transfer

group_idsstring[]

Limit workspace address entries to those belonging to these group IDs (comma-separated UUIDs)

min_usdnumber

Minimum USD amount (decimal). Converted to number.

max_usdnumber

Maximum USD amount (decimal). Converted to number.

categoriesstring[]

Comma-separated category names to filter by (workspace-specific enrichment). Requires workspace authentication.

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.

internal_transfer_idsstring[]

Comma-separated category names. Only returns transfers that the authenticated workspace has labelled with one of these categories.

only_workspaceboolean

If true, only returns transfers that the authenticated workspace has labelled with a category. If false, returns all transfers regardless of whether they have a category.

scope'INTERCHAIN' | 'INTRACHAIN' | 'ALL'

Response

List of token transfers that match the specified search term.

Example response

{
  "items": [
    {
      "id": "9359/AX/2352",
      "time": "2024-05-08T13:05:57.779Z",
      "status": "SUCCEEDED",
      "type": "cctp",
      "sender": {
        "id": "bje5mmbqxjvwjaf7oxwpyxntxdyspzZyt4vwennw5rug",
        "name": "Treasury wallet",
        "type": "eoa",
        "network": "solana",
        "address": "BJE5MMbqXjVwjAF7oxwPYXnTXDyspzZyt4vwenNw5ruG",
        "provider": "ledger, kraken, wallet, ...",
        "groups": [
          {
            "id": "uuid-1",
            "name": "Finance"
          }
        ],
        "status": "active",
        "balances": [
          {
            "asset": "USDC",
            "amount": "100.50",
            "usd": "100.50",
            "updated_at": "2024-01-01T00:00:00.000Z"
          }
        ],
        "balances_usd": "1234.56",
        "balances_updated_at": "2024-01-01T00:00:00.000Z",
        "details": {
          "network": "solana",
          "address": "BJE5MMbqXjVwjAF7oxwPYXnTXDyspzZyt4vwenNw5ruG"
        },
        "notes": "Primary treasury wallet",
        "role": "Treasury"
      },
      "receiver": {
        "id": "bje5mmbqxjvwjaf7oxwpyxntxdyspzZyt4vwennw5rug",
        "name": "Treasury wallet",
        "type": "eoa",
        "network": "solana",
        "address": "BJE5MMbqXjVwjAF7oxwPYXnTXDyspzZyt4vwenNw5ruG",
        "provider": "ledger, kraken, wallet, ...",
        "groups": [
          {
            "id": "uuid-1",
            "name": "Finance"
          }
        ],
        "status": "active",
        "balances": [
          {
            "asset": "USDC",
            "amount": "100.50",
            "usd": "100.50",
            "updated_at": "2024-01-01T00:00:00.000Z"
          }
        ],
        "balances_usd": "1234.56",
        "balances_updated_at": "2024-01-01T00:00:00.000Z",
        "details": {
          "network": "solana",
          "address": "BJE5MMbqXjVwjAF7oxwPYXnTXDyspzZyt4vwenNw5ruG"
        },
        "notes": "Primary treasury wallet",
        "role": "Treasury"
      },
      "sender_tx_hash": "76b9922b6c8968d328e56930b4bbe26665d2ed12f2bdff45b2e9a43b09f5ab9c",
      "receiver_tx_hash": "e607dba4c1e138dabb1d534ba0e14645786ca892907563c388d7de7f65ba7bb3"
    }
  ],
  "meta": {
    "next_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "previous_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "first_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "last_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "total_count": 100,
    "page_number": 1
  }
}