List transaction records

This operation retrieves on-chain transaction records, including transfers, contract calls, and deposits. When wallet_uuid is provided, records are scoped to that wallet (with permission enforcement). When omitted, records across all wallets visible to the authenticated principal are returned. Use cursor-based pagination with after/before.

GET /api/v1/wallets/transactions

List transaction records

Python

import requests

url = "https://api.example.com/api/v1/wallets/transactions"

response = requests.get(url)

print(response.text)

200

{
  "result": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "wallet_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "transfer",
      "chain_id": "<string>",
      "token_id": "<string>",
      "src_address": "<string>",
      "dst_address": "<string>",
      "amount": "<string>",
      "status": 123,
      "transaction_hash": "<string>",
      "data": {
        "sub_type": "<string>",
        "contract_addr": "<string>",
        "value": "<string>",
        "calldata": "<string>",
        "instructions": [
          {}
        ],
        "fee": {},
        "failed_reason": "<string>",
        "description": "<string>",
        "signature": "<string>",
        "destination_type": "<string>",
        "eip712_typed_data": {},
        "payment_required_raw": "<string>",
        "payment_signature_raw": "<string>",
        "siwx_header_value": "<string>",
        "mpp_authorization_header": "<string>",
        "pact_id": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "pact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "request_type": "transfer",
      "status_display": "",
      "sub_status": "<string>",
      "request_id": "<string>",
      "description": "<string>",
      "ext_transactions": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "user_transaction_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "operation_type": "transfer",
          "status": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "stage": "original",
          "provider": "waas",
          "external_id": "<string>",
          "caw_request_id": "<string>",
          "transaction_hash": "<string>",
          "data": {}
        }
      ]
    }
  ],
  "success": true,
  "suggestion": "",
  "message": "",
  "meta": {
    "total": 123,
    "offset": 123,
    "limit": 123,
    "has_more": true,
    "after": "<string>",
    "before": "<string>"
  }
}

Headers

X-API-Key · string | null

Query Parameters

wallet_uuid · string<uuid> | null

Filter records by wallet ID. When omitted, records from all wallets visible to the authenticated principal are returned.

after · string | null

A cursor for forward pagination. Pass the after value from a previous response to retrieve the next page.

before · string | null

A cursor for backward pagination. Pass the before value from a previous response to retrieve the preceding page.

offset · integer | null · deprecated

Deprecated. Use after/before cursors instead.

Required range: 0 <= x <= 9223372036854776000

limit · integer · default: 50

The maximum number of items to return. Range: [1, 200].

Required range: 1 <= x <= 200

status · string | null

Filter records by transaction status. Accepts UserTransactionStatus integer values (e.g. 900 for success, 901 for failed) or label strings (e.g. success, processing). If omitted, all statuses are returned.

type · string | null

Filter records by transaction type. Possible values: transfer, contract_call, deposit, message_sign, x402_payment, mpp_payment. If omitted, all types are returned.

token_id · string | null

Filter records by token ID (for example, SETH, SETH_USDC). Use the Cobo token ID format. If omitted, all tokens are returned.

chain_id · string | null

Filter records by Cobo chain ID (for example, ETH, BASE_ETH, SOL). If omitted, all chains are returned.

address_id · string | null

Filter records by blockchain address. Matches source or destination address. If omitted, records for all addresses are returned.

ext · boolean · default: false

When true, each record includes an ext_transactions list with the associated downstream (external) transactions.

Response

200

application/json

Successful Response

result · UserTransactionRead · object[] · required

Show child attributes

success · boolean · default: true

suggestion · string · default: ""

message · string · default: ""

meta · PaginationMeta · object

Pagination metadata for list responses.

Supports both legacy offset-based and cursor-based pagination. Cursor fields (has_more, after, before) are populated for cursor-paginated endpoints. Legacy fields (offset, limit) are populated when the caller uses the deprecated offset parameter.

Show child attributes