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/12989284778980e987410b6e10cf7f9c/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/12989284778980e987410b6e10cf7f9c/trades'

Response

200Example response7 ms · just now · 4.7 KB · 155 lines
https://api.xrpl.to/v1/testnet/tokens/12989284778980e987410b6e10cf7f9c/trades
{
  "success": true,
  "took": 2,
  "trades": [
    {
      "_id": "12989284778980e987410b6e10cf7f9c_20930535_1_FBAB2175",
      "maker": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
      "taker": "rPt2oPAuykoPuKNvtNp44gGu8L15uv4wo6",
      "seq": 20870336,
      "pair": "794dea7572afd8905c5f17544675ba71",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "value": 184.7672618238856
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 128.151232
      },
      "ledger": 20930535,
      "hash": "6B6D37D5DF2024BF9C22C7D0D5FAF31EB37A952960B97AD970F52845FBAB2175",
      "time": 1789975862000,
      "isAMM": false,
      "sourceTag": 7101,
      "md5s": [
        "12989284778980e987410b6e10cf7f9c",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "md5": "12989284778980e987410b6e10cf7f9c",
      "price": 0.6935819188691001,
      "xrp": 128.151232
    },
    {
      "_id": "12989284778980e987410b6e10cf7f9c_20930535_2_F10F5133",
      "maker": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
      "taker": "r4qE9CFCGhVCDKw32M8i6PDrfbzo3HVw3r",
      "seq": 20870336,
      "pair": "794dea7572afd8905c5f17544675ba71",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "value": 179.085384939987
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 124.131952
      },
      "ledger": 20930535,
      "hash": "1054ECEDAD23D7FB662E3FDBE0CC8E98A332F1C9246AE612735D2DC2F10F5133",
      "time": 1789975862000,
      "isAMM": false,
      "sourceTag": 7101,
      "md5s": [
        "12989284778980e987410b6e10cf7f9c",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "md5": "12989284778980e987410b6e10cf7f9c",
      "price": 0.6931439549999998,
      "xrp": 124.131952
    },
    {
      "_id": "84e5efeb89c4eae8f68188982dc290d8_20930535_3_D7F8ACF1",
      "maker": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
      "taker": "rJPCKotnXYSKyqEWEWQxydhECc67iwbxrz",
      "seq": 20870338,
      "pair": "794dea7572afd8905c5f17544675ba71",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 127.753521
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "value": 183.65529999999936
      },
      "ledger": 20930535,
      "hash": "6C14D7C4BBEE86B90F32DB8C6C47EC736096D33E100F5315D5648EA2D7F8ACF1",
      "time": 1789975862000,
      "isAMM": false,
      "sourceTag": 7101,
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "12989284778980e987410b6e10cf7f9c"
      ],
      "md5": "12989284778980e987410b6e10cf7f9c",
      "price": 0.6956157595234139,
      "xrp": 127.753521
    },
    {
      "_id": "84e5efeb89c4eae8f68188982dc290d8_20930535_4_809156AF",
      "maker": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
      "taker": "r9WcMQkdF5LcagjMJtoMgkGr48pSkifj3W",
      "seq": 20870338,
      "pair": "794dea7572afd8905c5f17544675ba71",
      "paid": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 112.035225
      },
      "got": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "value": 160.9569
      },
      "ledger": 20930535,
      "hash": "8FEA438CC1D32AB78BBF60A9942EBE3D9BC3CAE16A6F9B378A9B2FF0809156AF",
      "time": 1789975862000,
      "isAMM": false,
      "sourceTag": 7101,
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "12989284778980e987410b6e10cf7f9c"
      ],
      "md5": "12989284778980e987410b6e10cf7f9c",
      "price": 0.6960572985687473,
      "xrp": 112.035225
    },
    {
      "_id": "12989284778980e987410b6e10cf7f9c_20930535_5_4DFBDBFF",
      "maker": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
      "taker": "raiUcuEebEbWLLRKrttqhBmwqVgwFsESwY",
      "seq": 20870336,
      "pair": "794dea7572afd8905c5f17544675ba71",
      "paid": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "value": 96.5823796280909
      },
      "got": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 67.026414
      },
      "ledger": 20930535,
      "hash": "1E8FF90ECF3746695F839607FAB04B5282897F51BD8F980E2C5B343F4DFBDBFF",
      "time": 1789975862000,
      "isAMM": false,
      "sourceTag": 7101,
      "md5s": [
        "12989284778980e987410b6e10cf7f9c",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "md5": "12989284778980e987410b6e10cf7f9c",
      "price": 0.6939818034935373,
      "xrp": 67.026414
    }
  ],
  "count": 50,
  "total": 1702,
  "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. Testnet resets without warning; the data is rebuilt from the chain within minutes, and only objects touched since count. Open the Testnet sandbox →
OpenAPI