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 response2 ms · just now · 4.1 KB · 141 lines
https://api.xrpl.to/v1/history?md5=0dd550278b74cb6690fdae351e8e0df3&limit=5
{
  "success": true,
  "took": 1,
  "data": [
    {
      "_id": "107595266_8_FBDD08C3",
      "maker": "raRiscpYKJCueDMtC9DDkgEfhExSYBGCUs",
      "taker": "rDi2VysuPsU5oQRGPDTPiR9YPd34kzK9m8",
      "seq": 107453281,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 24.90578906573506
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 17.693191
      },
      "ledger": 107595266,
      "hash": "60D7FC5631300F9C736463B83F77EB5707037B118E04A4BDECFE7971FBDD08C3",
      "time": 1791766750000,
      "isAMM": false,
      "_hasDex": true,
      "_mergedXrp": 17.693191,
      "_mergedTok": 24.90578906573506,
      "fillSource": "DEX",
      "price": 0.7104047558301204,
      "marketcap": 811831935.5961746
    },
    {
      "_id": "107595266_2_7AF8E9E2",
      "maker": "rU8QEjAbNbXDnBR7kx9TLPXsAEng3axsz4",
      "taker": "rJ8C3FVkrrtUsZxEgeeTayjySpfGXaQr25",
      "seq": 99501244,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 41.45279688232134
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 29.448274
      },
      "ledger": 107595266,
      "hash": "1A4DD90194C97B7FC032A7C9EB319F6F3A5DCCF822282F7EB24984BF7AF8E9E2",
      "time": 1791766750000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.710404995918599,
      "marketcap": 811832209.9629953
    },
    {
      "_id": "107595266_1_7B83886A",
      "maker": "rU8QEjAbNbXDnBR7kx9TLPXsAEng3axsz4",
      "taker": "rPztkopzNn1ShL8JbeqbJZ3RyXZqcRBPyi",
      "seq": 99501244,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 1.4078490519436
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 1.000143
      },
      "ledger": 107595266,
      "hash": "CB62A3B4B5F939B4D97B4B5E52FFCF62BCA459C419E8DD243B409A9E7B83886A",
      "time": 1791766750000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.7104049959186014,
      "marketcap": 811832209.962998
    },
    {
      "_id": "107595266_10_AC704F45",
      "maker": "rJ4AgDd1ZqTqSgQ7YoA26tRNK3gTz6hCCm",
      "taker": "rnCEEqDnCuSjDsHiJrca4VYUqaMyi4vGF7",
      "seq": 107322075,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 0.710868
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 1
      },
      "ledger": 107595266,
      "hash": "F3E6CC7D7208765EB1E6190FB8EC664AB735DD2A3F98390E1FB8EAAAAC704F45",
      "time": 1791766750000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.710868,
      "marketcap": 812361318.8921065
    },
    {
      "_id": "107595265_6_3D16949B",
      "maker": "rKrVTQChbm1761udZt18u9Aq9onJwEyvZw",
      "taker": "rJ8C3FVkrrtUsZxEgeeTayjySpfGXaQr25",
      "seq": 107192976,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 1.5
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 2.111155
      },
      "ledger": 107595265,
      "hash": "EB81CBE5997864175D74FEBD56BDA58EC2849FC3ED256601BBBB51AB3D16949B",
      "time": 1791766741000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.7105115446284143,
      "marketcap": 811953971.0359819
    }
  ],
  "meta": {
    "total": 19558378,
    "offset": 0,
    "limit": 5,
    "direction": "desc",
    "nextCursor": 1791766741000,
    "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}