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

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

The order book of a Testnet token against XRP

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/offers
Path parameterValueDescription
md5The token's md5 (md5 of issuer_currency)
Query parameterValueDescription
limitper side, 1-100
curl 'https://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/offers'

Response

200Example response5 ms · just now · 8.9 KB · 300 lines
https://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/offers
{
  "success": true,
  "took": 4,
  "limit": 50,
  "bids": [
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21965611",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 698.450808
      },
      "hash": "EC0E92246F6C08AFB24F8512B83D2E59CCB9A6EB9C1616FEAE55027ED5775D22",
      "ledger": 22492363,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "2b5e3c50d0500edf86212000b9883dce"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 626.5926487162444
      },
      "price": 1.1146808208346806,
      "seq": 21965611,
      "side": "bid",
      "time": 1795243882000
    },
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21965335",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 726.445334
      },
      "hash": "6F8ECCB74C64BEDABCDD417CAAEBE5958CD3B3DF2957ECD55992C155848A99F1",
      "ledger": 22482456,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "2b5e3c50d0500edf86212000b9883dce"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 653.842939558257
      },
      "price": 1.111039502071849,
      "seq": 21965335,
      "side": "bid",
      "time": 1795210671000
    },
    {
      "_id": "r3mwsi991pihhKP6fZN2wmTBBFPkBDJVr7_21970838",
      "account": "r3mwsi991pihhKP6fZN2wmTBBFPkBDJVr7",
      "expire": 1795209905000,
      "flags": 65536,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 8.491397
      },
      "hash": "3554F60537154718541FA8B6EAAC944A0C4B7DAEDDB4A0BAFF2E18B9559F4172",
      "ledger": 22480955,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "2b5e3c50d0500edf86212000b9883dce"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 7.6456
      },
      "price": 1.1106253269854558,
      "seq": 21970838,
      "side": "bid",
      "time": 1795205602000
    },
    {
      "_id": "rsmsd5CCDiUP1VUB95VXyGRRzWbjhNYc4i_21972074",
      "account": "rsmsd5CCDiUP1VUB95VXyGRRzWbjhNYc4i",
      "flags": 65536,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 24.133626
      },
      "hash": "9804972661E3F6FF7662BE8B3E680D334EF4BCEA2945FAC01A3AD7C902BD5C4D",
      "ledger": 22482112,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "2b5e3c50d0500edf86212000b9883dce"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 21.7343
      },
      "price": 1.110393525441353,
      "seq": 21972074,
      "side": "bid",
      "time": 1795209502000
    },
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21961701",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 443.362103
      },
      "hash": "5CFEE51CAD155B72DA3D1C2FA2FAE10283ABEB64812E7DFFCC4EB8871C938477",
      "ledger": 22330691,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "2b5e3c50d0500edf86212000b9883dce"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 399.5614832625668
      },
      "price": 1.109621726748497,
      "seq": 21961701,
      "side": "bid",
      "time": 1794698471000
    }
  ],
  "asks": [
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21956482",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 958.5520819996016
      },
      "hash": "C240BFBB4FA467E0C77D10F646524B3DB94B41652FE6B18102377B7C4B55B5FB",
      "ledger": 22088968,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 748.180936
      },
      "price": 0.780532378,
      "seq": 21956482,
      "side": "ask",
      "time": 1793890660000
    },
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21956477",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 2000
      },
      "hash": "75A256002278D0B66508BADDA41CDE00ACF6B4881D1C7CB70E3269A93E1C56C9",
      "ledger": 22088840,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 1564.237124
      },
      "price": 0.782118562,
      "seq": 21956477,
      "side": "ask",
      "time": 1793890240000
    },
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21956504",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 776.2066806500883
      },
      "hash": "CF3DF8972C0BB6895A32D235618968A8FE8C31FE41DB17E3BA02BC5E7F616540",
      "ledger": 22089384,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 613.75578
      },
      "price": 0.790711797901517,
      "seq": 21956504,
      "side": "ask",
      "time": 1793892122000
    },
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21956492",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 953.9489784018881
      },
      "hash": "B64557F2E34AA0D28D0CF3CD39E4A12733D7AE87B1F4DE1575A41F9C39AE2395",
      "ledger": 22089238,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 755.651661
      },
      "price": 0.7921300594775126,
      "seq": 21956492,
      "side": "ask",
      "time": 1793891610000
    },
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21956505",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 2000
      },
      "hash": "D9A490DD9FD3F29AE6A88E57AD4FD81E73805FF7DA5694F12DBBFE3CD2FC7CC9",
      "ledger": 22089336,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 1586.944777
      },
      "price": 0.7934723885,
      "seq": 21956505,
      "side": "ask",
      "time": 1793891952000
    }
  ]
}

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