Skip to main content
GET
/
v1
/
transactions
cURL
curl --request GET \
  --url https://api.nxos.io/v1/transactions \
  --header 'Authorization: <authorization>'
{
  "object": "list",
  "data": [
    {
      "object": "transaction",
      "transactionId": "<string>",
      "accountId": "<string>",
      "status": "EXPECTED",
      "description": "<string>",
      "tags": [
        "<string>"
      ],
      "amount": "<string>",
      "asset": "<string>",
      "fee": {
        "fixed": "50.00",
        "bps": 0,
        "bpsAmount": "0.00",
        "total": "50.00",
        "asset": "USD"
      },
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "type": "CRYPTO_PAYIN",
      "details": {
        "chainName": "<string>",
        "chainTransactionId": "<string>",
        "fromAddress": "<string>",
        "toAddress": "<string>",
        "blockHeight": 123,
        "blockTimestamp": "<string>"
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Headers

​
Authorization
string
required

Bearer token. Format: Bearer <api_key>

Query Parameters

​
limit
integer<int32>
default:25

Maximum number of items to return. Defaults to 25, max 100.

​
cursor
string

Cursor for the next page of results, returned in previous responses.

​
accountId
string

Filter to a single account. Must belong to the API key's organization. Defaults to all accounts in the org.

​
type
string

Comma-separated TransactionType values to include. Empty/absent = all types. Example: ?type=CRYPTO_PAYOUT,FIAT_PAYOUT.

​
status
string

Comma-separated TransactionStatus values to include. Empty/absent = all statuses. Example: ?status=COMPLETED,LOCKED.

​
createdAtGte
string

Inclusive lower bound on createdAt (>=). ISO8601 string. ISO 8601 timestamp string.

​
createdAtLte
string

Inclusive upper bound on createdAt (<=). ISO8601 string. ISO 8601 timestamp string.

Response

The request has succeeded.

Paginated list envelope. All list endpoints return this shape.

​
object
enum<string>
required

Object type. Always list for paginated responses.

Available options:
list
​
data
object[]
required

Array of results.

A transaction, discriminated by type. Use the type field to narrow the details payload — each variant has a different shape. The envelope (status, amount, asset, fee, timestamps) is uniform across variants.

Variants:

  • CRYPTO_PAYIN → details is TransactionCryptoPayinDetails
  • CRYPTO_PAYOUT → details is TransactionCryptoPayoutDetails
  • FIAT_PAYIN → details is TransactionFiatPayinDetails
  • FIAT_PAYOUT → details is TransactionFiatPayoutDetails
  • TRADE → details is TransactionTradeDetails
  • TRANSFER → details is TransactionTransferDetails
  • NXOSNET_TRANSFER → details is TransactionNxosnetTransferDetails
  • ADJUSTMENT → details is TransactionAdjustmentDetails
  • COMMISSION → details is TransactionCommissionDetails
​
hasMore
boolean
required

Whether more results are available beyond this page.

​
nextCursor
string | null
required

Cursor to pass as cursor query parameter for the next page. Null when there are no more results.