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 response6 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_21164489",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 698.71512
      },
      "hash": "E480395E09E84FEF3FECF280B6962E783BEF547329F85F699AEB85947E313BC7",
      "ledger": 21467348,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 986.14445625771
      },
      "price": 0.7085322191553285,
      "seq": 21164489,
      "side": "bid",
      "time": 1791767060000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21164599",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 708.506739
      },
      "hash": "894C47CACBB062B1B9C78C2D106B21D6750E3DE6BF4F1DA6EC2A440D27077E93",
      "ledger": 21465305,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 1000
      },
      "price": 0.708506739,
      "seq": 21164599,
      "side": "bid",
      "time": 1791760182000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21164587",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 708.502024
      },
      "hash": "66F4B68C50F0685211C0099CB5BA7D90B803CBF3F87A11FCE9FCF780DE46C2BB",
      "ledger": 21465152,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 1000
      },
      "price": 0.708502024,
      "seq": 21164587,
      "side": "bid",
      "time": 1791759671000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21164353",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 708.502024
      },
      "hash": "804BDA266628F604B549303CEF2B84778084A8A1715CB043E472685DF26A4B56",
      "ledger": 21462594,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 1000
      },
      "price": 0.708502024,
      "seq": 21164353,
      "side": "bid",
      "time": 1791750922000
    },
    {
      "_id": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1_21164569",
      "account": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 708.490765
      },
      "hash": "D0CCFB5D4D174EA79455C8D4F66403871D8B106F20A5B35A9FA33C6CA7B39E2D",
      "ledger": 21465051,
      "md5": "ecfb8f46ab12687bf34adeda926a9adb",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "ecfb8f46ab12687bf34adeda926a9adb"
      ],
      "pair": "64465e024b74272b0daabdb69706e251",
      "pays": {
        "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 1000
      },
      "price": 0.708490765,
      "seq": 21164569,
      "side": "bid",
      "time": 1791759330000
    }
  ],
  "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