Skip to main content
GET
/
api
/
v1
/
transactions
List transactions
curl --request GET \
  --url https://api.paratro.com/api/v1/transactions \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "tx_id": "tx_w1x2y3z4a5",
      "wallet_id": "wal_a1b2c3d4e5f6",
      "client_id": "cli_x1y2z3",
      "chain": "ethereum",
      "transaction_type": "OUTBOUND",
      "from_address": "0x1234567890abcdef1234567890abcdef12345678",
      "to_address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "token_symbol": "USDT",
      "amount": "100.00",
      "status": "CONFIRMED",
      "created_at": "2026-01-15T11:00:00Z",
      "tx_hash": "0xabc123def456789..."
    }
  ],
  "total": 123,
  "has_more": true
}

​
List Transactions

Returns a paginated list of transactions with optional filters.
​
wallet_id
string
Filter by wallet ID.
​
account_id
string
Filter by account ID.
​
chain
string
Filter by chain name.
​
page
integer
default:1
Page number (min 1).
​
page_size
integer
default:10
Items per page (1-100).

​
Response

{
  "data": [
    {
      "tx_id": "tx_01HXYZ...",
      "wallet_id": "w_01HXYZ...",
      "client_id": "c_01HXYZ...",
      "chain": "ethereum",
      "transaction_type": "OUTBOUND",
      "from_address": "0xaaaa...",
      "to_address": "0xbbbb...",
      "token_symbol": "USDT",
      "amount": "100.50",
      "status": "CONFIRMED",
      "tx_hash": "0xabcdef...",
      "created_at": "2025-01-15T10:30:45+08:00"
    }
  ],
  "total": 42,
  "has_more": true
}
transaction_type can include OUTBOUND, X402_SIGN, or X402_SETTLE. status values depend on the transaction type.

Authorizations

​
Authorization
string
header
required

JWT access token obtained from the /api/v1/auth/token endpoint.

Query Parameters

​
wallet_id
string

Filter transactions by wallet ID.

​
account_id
string

Filter transactions by account ID.

​
chain
string

Filter transactions by chain name.

​
page
integer
default:1

Page number for pagination.

Required range: x >= 1
​
page_size
integer
default:10

Number of items per page.

Required range: 1 <= x <= 100

Response

List of transactions retrieved successfully.

​
data
object[]
required
​
total
integer
required

Total number of transactions.

​
has_more
boolean
required

Whether there are more results beyond the current page.