Skip to main content
GET
Wallet trade history

Authorizations

X-Api-Key
string
header
required

API key (programmatic access — recommended)

Send your API key in the X-Api-Key header. Keys start with nxs_ and are created in the dashboard (or via POST /api/keys with a session JWT).

Each key is scoped to one chain and one network (for example CARDANO_MAINNET), fixed at creation time. It cannot query a different network on the same chain, and it cannot query a different chain at all. A mismatched network parameter returns 400 Network Mismatch. Create one key per chain and network under the same account.

This is the credential most integrations should use.

Path Parameters

stakeAddress
string
required

Query Parameters

limit
integer<int32>

Rows per page, 1 to 500.

cursor
string

nextCursor of the previous page.

order
string

desc (default, newest first) or asc, by blockTime then txHash.

from
integer<int64>

Earliest blockTime, unix seconds, inclusive.

to
integer<int64>

Latest blockTime, unix seconds, inclusive.

unit
string

Only this token: policy id + asset name hex.

venue
string

Only trades through this venue: a DEX name (MINSWAP_V2, SPLASH, ...) or SOLADA.

side
string

BUY or SELL.

network
string

Target Cardano network for per-network market-data instances (e.g. preview or preprod). Omit, or pass mainnet, for mainnet.

Response

One page of the wallet's trades.

One page of the wallet's trades of one token against ADA.

stakeAddress
string
computedAt
integer<int64>

When the list was computed, unix seconds. Pages of one list share it.

indexedFrom
integer<int64>

Start of the indexer's own history, unix seconds. Before it, direct pool swaps are not listed (see coverage).

items
object[]
nextCursor
string

Opaque cursor for the next page, null on the last page.

coverage
object

What the list includes and what it deliberately leaves out. The same on every page.