GET /v1/testnet/tokens/{md5}/trades

Request

GEThttps://api.xrpl.to/v1/testnet/tokens/ecfb8f46ab12687bf34adeda926a9adb/trades

Path parameter	Value	Description
md5		The token's md5 (md5 of issuer_currency)

Query parameter	Value	Description
limit		1-200
page		from 1

curl 'https://api.xrpl.to/v1/testnet/tokens/ecfb8f46ab12687bf34adeda926a9adb/trades'

Response

200Example response49 ms · just now · 4.6 KB · 152 lines

https://api.xrpl.to/v1/testnet/tokens/ecfb8f46ab12687bf34adeda926a9adb/trades

{
  "success": true,
  "took": 48,
  "trades": [
    {
      "_id": "ecfb8f46ab12687bf34adeda926a9adb_21467348_1_7E313BC7",
      "maker": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "taker": "rUA4oJi7nG3iJ2k4thaq7G3rXFYpjKLP9r",
      "seq": 21164489,
      "pair": "64465e024b74272b0daabdb69706e251",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "value": 1126.577312000003
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 798.282984
      },
      "ledger": 21467348,
      "hash": "E480395E09E84FEF3FECF280B6962E783BEF547329F85F699AEB85947E313BC7",
      "time": 1791767060000,
      "isAMM": false,
      "md5s": [
        "ecfb8f46ab12687bf34adeda926a9adb",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "price": 0.7085913904859447,
      "xrp": 798.282984
    },
    {
      "_id": "84e5efeb89c4eae8f68188982dc290d8_21467329_1_BF0F677A",
      "maker": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "taker": "rUA4oJi7nG3iJ2k4thaq7G3rXFYpjKLP9r",
      "seq": 21164671,
      "pair": "64465e024b74272b0daabdb69706e251",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 499.90999
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "value": 703.115297459479
      },
      "ledger": 21467329,
      "hash": "A9DEC839F736E5FE32E622719A1DF69B7D54C551BEDBB6E79494CCC3BF0F677A",
      "time": 1791766991000,
      "isAMM": false,
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "price": 0.710992908,
      "xrp": 499.90999
    },
    {
      "_id": "84e5efeb89c4eae8f68188982dc290d8_21467301_1_F004C663",
      "maker": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "taker": "rUA4oJi7nG3iJ2k4thaq7G3rXFYpjKLP9r",
      "seq": 21164665,
      "pair": "64465e024b74272b0daabdb69706e251",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 301.009971
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "value": 423.4620133250621
      },
      "ledger": 21467301,
      "hash": "E7F0921F006E8E6E399EED6F44523CFFA3942061F59D15BA1741B420F004C663",
      "time": 1791766900000,
      "isAMM": false,
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "price": 0.7108311053367985,
      "xrp": 301.009971
    },
    {
      "_id": "84e5efeb89c4eae8f68188982dc290d8_21467242_1_794244A8",
      "maker": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "taker": "rhtPBwqiwguKRytUbb9bf3HHbTycysb2nd",
      "seq": 21164665,
      "pair": "64465e024b74272b0daabdb69706e251",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 52.541735
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "value": 73.9838332356716
      },
      "ledger": 21467242,
      "hash": "007EF4971AAAB57CBD0115F4F3E811BE4BD484B4F11F927931CB5EA3794244A8",
      "time": 1791766702000,
      "isAMM": false,
      "sourceTag": 7101,
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "price": 0.7101785985139628,
      "xrp": 52.541735
    },
    {
      "_id": "84e5efeb89c4eae8f68188982dc290d8_21467242_2_C35AACAE",
      "maker": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "taker": "rapd6a7m5EBZ5Q9pCCgks8Wnfi2Wnxvcsp",
      "seq": 21164665,
      "pair": "64465e024b74272b0daabdb69706e251",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 4.954914
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "value": 6.9699
      },
      "ledger": 21467242,
      "hash": "59A4F5C5C52848FAD8BBD8594CFA751A68636407C00E90AC632D326CC35AACAE",
      "time": 1791766702000,
      "isAMM": false,
      "sourceTag": 7101,
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "price": 0.7109017346016442,
      "xrp": 4.954914
    }
  ],
  "count": 50,
  "total": 58699,
  "page": 1,
  "limit": 50
}

Long arrays and strings are shortened in the example; Send request for the full answer.

Shapeas documented

{
  trades: [
    {
      maker,
      taker,
      paid,
      got,
      price,
      xrp,
      isAMM,
      hash,
      ledger,
      time
    }
  ],
  count,
  total
}

What it does

Fills of a Testnet token, newest first

Start at GET /v1/testnet/fixtures: it names live accounts, a busy token, an NFT with offers and one of every ledger object that xrpl.to keeps alive on Testnet, plus a real transaction of every type. The busiest token gains holders every hour, so its GET /v1/testnet/tokens/{md5}/holders is the place to test paginating a long list. Testnet resets without warning; the data is rebuilt from the chain within minutes, and only objects touched since count. Open the Testnet sandbox →

OpenAPI

/v1/testnet/tokens/{md5}/trades

Request

Response

What it does

Also in Testnet