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

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

Fills of a Testnet token, newest first

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/trades
Path parameterValueDescription
md5The token's md5 (md5 of issuer_currency)
Query parameterValueDescription
limit1-200
pagefrom 1
curl 'https://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/trades'

Response

200Example response30 ms · just now · 4.7 KB · 155 lines
https://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/trades
{
  "success": true,
  "took": 28,
  "trades": [
    {
      "_id": "84e5efeb89c4eae8f68188982dc290d8_22503773_1_1515077B",
      "maker": "rHh8QTC8Jr8dEwzUWTQxdFF3ZBhKGp1gAk",
      "taker": "rEJJHbJ8ex6iGN9LoQwJhsGbyWP65RQ3Nj",
      "seq": null,
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 9.921062
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "value": 9.28112589828
      },
      "ledger": 22503773,
      "hash": "0AF763A91B61620952548174D4B71B496ACBE75A36EE6B9EFB8907E31515077B",
      "time": 1795282251000,
      "isAMM": true,
      "sourceTag": 7003,
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "2b5e3c50d0500edf86212000b9883dce"
      ],
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "price": 1.0689502662428698,
      "xrp": 9.921062
    },
    {
      "_id": "2b5e3c50d0500edf86212000b9883dce_22503773_4_48889E4C",
      "maker": "rsmsd5CCDiUP1VUB95VXyGRRzWbjhNYc4i",
      "taker": "rp5xSm78RgLUnLj8NFs4jw8DtANMPC84cV",
      "seq": 21972553,
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "value": 10.23708981696637
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 10.933135
      },
      "ledger": 22503773,
      "hash": "BF1B1C3A0710411E9373EF29B2E4FA55857E0D490CE7AA3B952CC00D48889E4C",
      "time": 1795282251000,
      "isAMM": false,
      "sourceTag": 7003,
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "price": 1.067992485704291,
      "xrp": 10.933135
    },
    {
      "_id": "2b5e3c50d0500edf86212000b9883dce_22503770_2_9EBAD6C7",
      "maker": "r3mwsi991pihhKP6fZN2wmTBBFPkBDJVr7",
      "taker": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "seq": 21971302,
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "value": 28.0092363680846
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 29.959932
      },
      "ledger": 22503770,
      "hash": "879237E3E034D55BFAD62760ED2D6FF4B99659CAF8A8436B1543ECAE9EBAD6C7",
      "time": 1795282241000,
      "isAMM": false,
      "sourceTag": 7100,
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "price": 1.0696447274134948,
      "xrp": 29.959932
    },
    {
      "_id": "2b5e3c50d0500edf86212000b9883dce_22503683_1_DDB0AC28",
      "maker": "r453rpyijXZ3S8qpXb1G1bRZq8TRAiFaaW",
      "taker": "rM1EKHCJbCG8W2aC9ikhWnGt3Gi5y5ooCu",
      "seq": 21972418,
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "value": 31.76992116052006
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 34.053503
      },
      "ledger": 22503683,
      "hash": "55AE81BD76EC2C5768D0B9D66718E5370AFA4014E4F767F3F2039BF0DDB0AC28",
      "time": 1795281950000,
      "isAMM": false,
      "sourceTag": 7101,
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "price": 1.0718787380032189,
      "xrp": 34.053503
    },
    {
      "_id": "2b5e3c50d0500edf86212000b9883dce_22503683_2_2E858F04",
      "maker": "rHh8QTC8Jr8dEwzUWTQxdFF3ZBhKGp1gAk",
      "taker": "rMdUAe9qH81CPeTtcthM1SKdEogqSEMv8r",
      "seq": null,
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "value": 13.38256818179
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 14.345687
      },
      "ledger": 22503683,
      "hash": "622EDF41AEF72133C599CF6ECEE2498A5FDF031AEEDEFF6C58FE5CD62E858F04",
      "time": 1795281950000,
      "isAMM": true,
      "sourceTag": 7101,
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "price": 1.0719681607541174,
      "xrp": 14.345687
    }
  ],
  "count": 50,
  "total": 50346,
  "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