Trades

Deprecated

get

Retrieve a list of trades.

Query parameters

addressstring · xrp-addressOptional

Address of the account

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

assetIdstring · uuidOptional

Unique UUID of asset in scope of this gateway, if provided will filter results by provided asset

Example: 4e49b359-c36c-42cd-916a-2bc6eae218b5

Responses

200

Successfully retrieved a list of items.

application/json

get

/trades

HTTPcURLJavaScriptPython

GET /trades HTTP/1.1
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "created_at": "2026-03-22T12:30:18.126Z",
      "updated_at": "2026-03-22T12:30:18.126Z",
      "id": "145be240-c75e-4cbd-b18b-0562a2b4f014",
      "order_id_1": "cbab96cc-b5fe-41e1-904b-0a8e4d460168",
      "order_id_2": "17aa3d48-1c9a-4c31-9add-6dac7058be59",
      "buy_amount_1": 1,
      "buy_amount_2": 2,
      "match_ratio": 2
    }
  ]
}

Deprecated

get

Retrieve full specific trade information.

Path parameters

orderMatchIdstring · uuidRequired

Order Match UUID identifier, unique in scope of this node

Example: c808c001-d738-469f-b5b0-8e44013bf86b

Responses

200

Successfully received a trade

application/json

created_atstring · date-timeRequired

Created date

updated_atstring · date-timeRequired

Updated date

idstring · uuidRequired

Unique identifier for the order match in scope of this gateway

Example: 145be240-c75e-4cbd-b18b-0562a2b4f014

order_id_1string · uuidRequired

Unique identifier for the first order in the match in scope of this gateway

Example: cbab96cc-b5fe-41e1-904b-0a8e4d460168

order_id_2string · uuidRequired

Unique identifier for the second order in the match in scope of this gateway

Example: 17aa3d48-1c9a-4c31-9add-6dac7058be59

buy_amount_1numberRequired

Buy amount of the first order in the match

Example: 1

buy_amount_2numberRequired

Buy amount of the second order in the match

Example: 2

match_rationumberRequired

Ratio of the match/price

Example: 2

get

/trades/{orderMatchId}

HTTPcURLJavaScriptPython

GET /trades/{orderMatchId} HTTP/1.1
Accept: */*

200

Successfully received a trade

{
  "created_at": "2026-03-22T12:30:18.126Z",
  "updated_at": "2026-03-22T12:30:18.126Z",
  "id": "145be240-c75e-4cbd-b18b-0562a2b4f014",
  "order_id_1": "cbab96cc-b5fe-41e1-904b-0a8e4d460168",
  "order_id_2": "17aa3d48-1c9a-4c31-9add-6dac7058be59",
  "buy_amount_1": 1,
  "buy_amount_2": 2,
  "match_ratio": 2
}