trades
Page-based list of trades with sort + direction
get
/trade/list
operationId: trade-list

Paginated, sortable trade list. Uses 1-indexed page + pageSize and returns total / pageCount. All filters are optional — call without any to get the global firehose. Optional pair-side filters: tradePairId (any base/quote), tokenSlug (resolves to the token/XRP pair), mptIssuanceId (resolves to the MPT/XRP pair); tradePairId wins when multiple are supplied. Optional account scopes to a taker. Optional pair-class booleans onlyIOU / onlyMPT / onlyXRP filter on the underlying trade_pairs shape and may be combined (e.g. onlyIOU=true&onlyXRP=true returns IOU/XRP markets only). sort accepts recent (default — alias of timestamp), timestamp, ledger_index, price, base_amount, or quote_amount; sortDir defaults to desc.

Unlock protected endpoints

Enter your Bearer token once to enable every protected route in this API reference.

HTTP bearer

Saved for this browser tab only. The credential is never sent until you test an endpoint.

Authorizations
NameLocationDetails
BearerAuthAuthorization header · bearerJWT issued by the Honeycluster auth service for the `indexer` audience. Present as `Authorization: Bearer <token>`.
Query Parameters
NameTypeDefaultDescription
page
integer1
pageSize
integer20
tradePairId
string
tokenSlug
string
mptIssuanceId
string
account
string
onlyIOU
boolean
onlyMPT
boolean
onlyXRP
boolean
sort
enum<string>"recent"
Available
recenttimestampledger_indexpricebase_amountquote_amount
sortDir
enum<string>"desc"
Available
ascdesc
Responses
200
application/json
Successful response
FieldTypeDescription
items
object[]
Items on the current page.
items[].id
string
UUID — part of the composite PK (id, timestamp).
items[].tradePairId
string
Parent trade_pairs.id.
items[].txHash
string
Transaction hash of the trade.
items[].ledgerIndex
integer
Ledger sequence of the trade.
items[].timestamp
integer
When the trade executed on-ledger, Unix-seconds.
items[].takerAddress
string
XRPL address that took liquidity.
items[].baseAmount
string
Base asset traded, decimal string.
items[].quoteAmount
string
Quote asset traded, decimal string.
items[].price
string
Execution price (quote / base), decimal string.
items[].sourceTag
object
items[].createdAt
integer
Record creation timestamp, Unix-seconds.
items[].tradePair
object
Trade pair the trade belongs to.
page
integer
1-indexed page number of the returned page.
pageSize
integer
Items per page (echoed from the request).
total
integer
Total number of items across all pages.
pageCount
integer
Total number of pages at the requested pageSize.
Example
Json
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "tradePairId": "00000000-0000-0000-0000-000000000000",
      "txHash": "string",
      "ledgerIndex": 0,
      "timestamp": 1745798400,
      "takerAddress": "string",
      "baseAmount": "string",
      "quoteAmount": "string",
      "price": "string",
      "sourceTag": 0,
      "createdAt": 1745798400,
      "tradePair": {
        "id": "00000000-0000-0000-0000-000000000000",
        "createdAt": 1745798400,
        "updatedAt": 1745798400,
        "baseCurrency": "string",
        "baseIssuer": "string",
        "quoteCurrency": "string",
        "quoteIssuer": "string"
      }
    }
  ],
  "page": 0,
  "pageSize": 0,
  "total": 0,
  "pageCount": 0
}
400
application/json
Invalid input data
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
401
application/json
Authorization not provided
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
403
application/json
Insufficient access
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
404
application/json
Not found
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
500
application/json
Internal server error
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}