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

Request

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

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

Query parameter	Value	Description
limit		per side, 1-100

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

Response

200Example response5 ms · just now · 8.8 KB · 299 lines

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

{
  "success": true,
  "took": 3,
  "limit": 50,
  "bids": [
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21184582",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 234.030284
      },
      "hash": "54626032CA0BD8F3CAB7EECDF03D7115132428D154CE18AA00F13DE57A1EEBFB",
      "ledger": 21614957,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 299.6056867047636
      },
      "price": 0.7811276433835427,
      "seq": 21184582,
      "side": "bid",
      "time": 1792273362000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21184575",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 161.707703
      },
      "hash": "359FF80CB0C94235A80BD0AC24E610FEFCA637FA12B245F1D09B3E3C4F4D4925",
      "ledger": 21614844,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 207.1885003114393
      },
      "price": 0.7804858993473384,
      "seq": 21184575,
      "side": "bid",
      "time": 1792272982000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21184568",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 578.403185
      },
      "hash": "881202679DBB051FBCA1D6C9EC4CD6C8D71DEEED8724075336408C0B8B26434C",
      "ledger": 21614809,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 742.884235657168
      },
      "price": 0.7785912760530377,
      "seq": 21184568,
      "side": "bid",
      "time": 1792272871000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21184583",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 1556.773688
      },
      "hash": "147750B57F6761353A895BF0E841A65CF9EC83FC4466A2AF3228DEF86489040A",
      "ledger": 21614911,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 2000
      },
      "price": 0.778386844,
      "seq": 21184583,
      "side": "bid",
      "time": 1792273210000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21184588",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 778.351299
      },
      "hash": "B2B822B27679A97CD1094EEBAB873C7621D3FE12E3456A5F2B710BEDD7FA27E4",
      "ledger": 21614945,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 1000
      },
      "price": 0.778351299,
      "seq": 21184588,
      "side": "bid",
      "time": 1792273322000
    }
  ],
  "asks": [
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21132695",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 139.8777995676479
      },
      "hash": "8399B5D6F24B9C7645BBE71763EB581DF18980D36081F422ACE8757D8CBC8DEC",
      "ledger": 21219148,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "ecfb8f46ab12687bf34adeda926a9adb",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 90.596473
      },
      "price": 0.647683001019655,
      "seq": 21132695,
      "side": "ask",
      "time": 1790938290000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21132682",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 369.0009509353038
      },
      "hash": "3C781BC52C957CF8466C60AAFB6870DF3F170464EF490E5CFA46982029B2FEBB",
      "ledger": 21218908,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "ecfb8f46ab12687bf34adeda926a9adb",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 239.350547
      },
      "price": 0.6486447972378392,
      "seq": 21132682,
      "side": "ask",
      "time": 1790937500000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21132701",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 1000
      },
      "hash": "7AE141DE40C935C1A6A03075EC5EC2CDA2FAC90090B6A27B514D51D093E191CF",
      "ledger": 21219029,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "ecfb8f46ab12687bf34adeda926a9adb",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 648.812722
      },
      "price": 0.648812722,
      "seq": 21132701,
      "side": "ask",
      "time": 1790937901000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21132707",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 1000
      },
      "hash": "4039D2EB07CB687ACC0958EA92382EB295F1BDA92E8623A9642365A92741A286",
      "ledger": 21219068,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "ecfb8f46ab12687bf34adeda926a9adb",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 648.951321
      },
      "price": 0.648951321,
      "seq": 21132707,
      "side": "ask",
      "time": 1790938030000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21132690",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 2000
      },
      "hash": "FB7719EE0A13E29414F11003DB334CD3CE111D2CA3219B24CCE888E40288F523",
      "ledger": 21218950,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "ecfb8f46ab12687bf34adeda926a9adb",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 1298.428914
      },
      "price": 0.649214457,
      "seq": 21132690,
      "side": "ask",
      "time": 1790937632000
    }
  ]
}

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

Shapeas documented

{ bids[], asks[] } — price is XRP per token; a bid gives XRP, an ask takes it

What it does

The order book of a Testnet token against XRP

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}/offers

Request

Response

What it does

Also in Testnet