XRPL.to
GET /history
GET

/v1/history

Trade history by token, account, or both

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/history?md5=0dd550278b74cb6690fdae351e8e0df3&limit=5
Query parameterValueDescription
md5token id (optional if account provided)
accountr-address
limitint (max 1000)
offsetint
start_timeunix ms
end_timeunix ms
typetrades|liquidity|all (default: trades)
liquidity_typecreate|deposit|withdraw
pair_typexrp|token
xrp_onlybool
xrp_amountfloat (min XRP threshold)
cursorint
directionasc|desc (default: desc)
curl 'https://api.xrpl.to/v1/history?md5=0dd550278b74cb6690fdae351e8e0df3&limit=5'

Response

200Example response3 ms · just now · 4.0 KB · 138 lines
https://api.xrpl.to/v1/history?md5=0dd550278b74cb6690fdae351e8e0df3&limit=5
{
  "success": true,
  "took": 2,
  "data": [
    {
      "_id": "107131951_2_65D3EDD5",
      "maker": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "taker": "rnCEEqDnCuSjDsHiJrca4VYUqaMyi4vGF7",
      "seq": 129009014,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 1845
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 1280.54748
      },
      "ledger": 107131951,
      "hash": "58FA732F793AC59D8B3C1AF98294B193BF2F7FC5512F637046EEC3A665D3EDD5",
      "time": 1789975820000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.6940636747967479,
      "marketcap": 719314847.5164443
    },
    {
      "_id": "107131950_5_02BC8724",
      "maker": "rL5GetGSnvorYFgM8c8G35b7mD8xcndjNk",
      "taker": "rai4ovpdYhkdSNMNgX9hJkBRMwXf7nkyTJ",
      "seq": 93500359,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 150.69802176
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 104.651404
      },
      "ledger": 107131950,
      "hash": "32084B48C7A1FDFC234C9277F01101E9AAD8797B05305C0B151E97F702BC8724",
      "time": 1789975811000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.6944444444444445,
      "marketcap": 719709470.1872705
    },
    {
      "_id": "107131950_3_D12752F2",
      "maker": "rL5GetGSnvorYFgM8c8G35b7mD8xcndjNk",
      "taker": "rawMTWphfwj52apazA9r3fMBxUw2NmM5TN",
      "seq": 93500359,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 7.30121472
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 5.070288
      },
      "ledger": 107131950,
      "hash": "B6601657133E996127CA5C4C1142B476FBA1579641ACD912E87BB3BCD12752F2",
      "time": 1789975811000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.6944444444444444,
      "marketcap": 719709470.1872704
    },
    {
      "_id": "107131950_2_517A680E",
      "maker": "rL5GetGSnvorYFgM8c8G35b7mD8xcndjNk",
      "taker": "rhurES4L8PkHDww77T3X1insxJXyG3WJA1",
      "seq": 93500359,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 22.00076352
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 15.278308
      },
      "ledger": 107131950,
      "hash": "39917A156A9BAC67EC61EBBDA6BB729E72CA7F791C168D5C5D819312517A680E",
      "time": 1789975811000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.6944444444444445,
      "marketcap": 719709470.1872705
    },
    {
      "_id": "107131950_1_82F16899",
      "maker": "rPU3jDj7QtHgaU9CHzYjyW6FcCx3dop2ZL",
      "taker": "rpK3DLr8vDhPDGEPRKSjb65gdgehDga4ZZ",
      "seq": 96100360,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 11
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 7.641183
      },
      "ledger": 107131950,
      "hash": "A6C1646A961C67C5DACC6E8E87E4171E61C44B15D0D0E7434C4BC46482F16899",
      "time": 1789975811000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.694653,
      "marketcap": 719925613.3353571
    }
  ],
  "meta": {
    "total": 18855070,
    "offset": 0,
    "limit": 5,
    "direction": "desc",
    "nextCursor": 1789975811000,
    "hasMore": true,
    "timeRange": {
      "startTime": null,
      "endTime": null
    }
  }
}
Shapeas documented
{
  success,
  took,
  data[],
  meta: {
    total,
    offset,
    limit,
    direction,
    nextCursor,
    hasMore,
    truncated?,
    timeRange
  }
}

What it does

Trade history by token, account, or both

Notes
Offset pagination capped at 100k rows (meta.truncated: true, total capped to servable window; use cursor for deeper history). Trades carry sourceTag (numeric, on-chain SourceTag) and/or platform (canonical name for memo-identified platforms, e.g. SPYDEX)
A token id can be its md5, slug or issuer_currency. How to build an md5 →
OpenAPI
PrevGET/stats/ratesNextGET/whale-activity/{id}