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 parameter	Value	Description
md5		token id (optional if account provided)
account		r-address
limit		int (max 1000)
offset		int
start_time		unix ms
end_time		unix ms
type		trades\|liquidity\|all (default: trades)
liquidity_type		create\|deposit\|withdraw
pair_type		xrp\|token
xrp_only		bool
xrp_amount		float (min XRP threshold)
cursor		int
direction		asc\|desc (default: desc)

curl 'https://api.xrpl.to/v1/history?md5=0dd550278b74cb6690fdae351e8e0df3&limit=5'

Response

200Example response2 ms · just now · 4.2 KB · 141 lines

https://api.xrpl.to/v1/history?md5=0dd550278b74cb6690fdae351e8e0df3&limit=5

{
  "success": true,
  "took": 1,
  "data": [
    {
      "_id": "107756481_2_084F16A9",
      "maker": "rBkv6fp1CeioxFCTPJZDnJ2Mhi8sheuXBn",
      "taker": "rhubarbMVC2nzASf3qSGQcUKtLnAzqcBjp",
      "seq": null,
      "pair": "0cf7b62dfda0d526486c7f25f4d3fd71",
      "paid": {
        "currency": "4C41574153000000000000000000000000000000",
        "issuer": "rfAWYnEAkQGAhbESWAMdNccWJvdcrgugMC",
        "value": 1011.3576316
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 0.0148702746341
      },
      "ledger": 107756481,
      "hash": "32709D3827527651183EF116FEA4CD7082E072B5A2BDD3F0D3345223084F16A9",
      "time": 1792392460000,
      "isAMM": true,
      "fillSource": "AMM",
      "price": 68012.03451083477,
      "marketcap": 69388830817106.39
    },
    {
      "_id": "107756481_1_084F16A9",
      "maker": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
      "taker": "rhubarbMVC2nzASf3qSGQcUKtLnAzqcBjp",
      "seq": 109163537,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 0.011336
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 0.014870274633
      },
      "ledger": 107756481,
      "hash": "32709D3827527651183EF116FEA4CD7082E072B5A2BDD3F0D3345223084F16A9",
      "time": 1792392460000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.7623262030980407,
      "marketcap": 777758294.0235409
    },
    {
      "_id": "107756480_8_83A0D583",
      "maker": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
      "taker": "rhubarbMVC2nzASf3qSGQcUKtLnAzqcBjp",
      "seq": 109163537,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 0.005437
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 0.007132067946
      },
      "ledger": 107756480,
      "hash": "9BBF28AE303DF4B04DBF9DAA1344F7ECFE42BCB7FE9B02D4D09E678583A0D583",
      "time": 1792392452000,
      "isAMM": false,
      "fillSource": "DEX",
      "price": 0.7623314922356181,
      "marketcap": 777763690.2313615
    },
    {
      "_id": "107756480_10_83A0D583",
      "maker": "rDZ5JQmxX7zKCLRo2fCh2F32CrGYeVbNJv",
      "taker": "rhubarbMVC2nzASf3qSGQcUKtLnAzqcBjp",
      "seq": null,
      "pair": "d6183ac39174dddb22bddafa2d10eaa2",
      "paid": {
        "currency": "5557000000000000000000000000000000000000",
        "issuer": "rDbS53G2nP3ksrNSea3rjFSZa3grkzVtf6",
        "value": 0.04095314984712
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 0.0071320679461209
      },
      "ledger": 107756480,
      "hash": "9BBF28AE303DF4B04DBF9DAA1344F7ECFE42BCB7FE9B02D4D09E678583A0D583",
      "time": 1792392452000,
      "isAMM": true,
      "fillSource": "AMM",
      "price": 5.742114370824837,
      "marketcap": 5858354414.4112625
    },
    {
      "_id": "107756479_9_004098E1",
      "maker": "rKoXaBw8pzkNaaLdMpzKqNbGjBpypmVPgH",
      "taker": "rfPXopKnvj6wjfFnutf6WvRWiX7Uk7AJzY",
      "seq": 106582768,
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 277
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 210.90716300000003
      },
      "ledger": 107756479,
      "hash": "AADF981E7C2DC638545F9ACE899191F9FCDE21DB5E29611EDDA7FA0B004098E1",
      "time": 1792392451000,
      "isAMM": false,
      "_hasDex": true,
      "_mergedXrp": 210.90716300000003,
      "_mergedTok": 277,
      "fillSource": "DEX",
      "price": 0.761397700361011,
      "marketcap": 776810995.2139057
    }
  ],
  "meta": {
    "total": 20232485,
    "offset": 0,
    "limit": 5,
    "direction": "desc",
    "nextCursor": 1792392451000,
    "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/rates NextGET/whale-activity/{id}

/v1/history

Request

Response

What it does

Also under Trades