Skip to main content
GET
List transactions
Only confirmed rows are returned. A pending or failed attempt never appears here. There’s no status filter to request otherwise; status on each item is always confirmed.
This row carries additional internal ledger fields (settlement batch references, dispute markers, raw card-processor fee) beyond what’s documented here. Treat any field not listed as forward-compatible and safe to ignore. Don’t build logic against undocumented keys.

Invoices

Every settled inbound transaction has a matching invoice.

Webhooks

Get notified the moment a transaction settles, instead of polling this list.

Authorizations

x-api-key
string
header
required

Your secret key, from app.agentaos.ai -> Settings -> Developers -> API Keys. The key's prefix is both its identity and its environment: sk_test_... (sandbox, free, no verification) or sk_live_... (real money, requires business verification). A missing or invalid key returns 401.

Query Parameters

direction
enum<string>
default:all
Available options:
all,
inbound,
outbound
from
string

ISO 8601 date or datetime, inclusive lower bound.

to
string

ISO 8601 date or datetime, inclusive upper bound.

fiatCurrency
enum<string>

Filter to rows settled/presented in this fiat currency.

Available options:
EUR,
USD
networks
string

Comma-separated CAIP-2 network IDs to filter by, e.g. eip155:8453,eip155:84532. Ignored if your API key is network-scoped.

limit
integer
default:20

Items per page. Capped server-side at 5000.

Required range: 1 <= x <= 5000
offset
integer
default:0

Number of items to skip, for the next page.

Required range: x >= 0

Response

A page of transactions.

items
object[]
required
total
integer
required
hasMore
boolean
required