XRPL.to
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/12989284778980e987410b6e10cf7f9c/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/12989284778980e987410b6e10cf7f9c/offers'

Response

200Example response14 ms · just now · 8.9 KB · 301 lines
https://api.xrpl.to/v1/testnet/tokens/12989284778980e987410b6e10cf7f9c/offers
{
  "success": true,
  "took": 4,
  "limit": 50,
  "bids": [
    {
      "_id": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP_20870336",
      "account": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 454.948658
      },
      "hash": "1E8FF90ECF3746695F839607FAB04B5282897F51BD8F980E2C5B343F4DFBDBFF",
      "ledger": 20930535,
      "md5": "12989284778980e987410b6e10cf7f9c",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "12989284778980e987410b6e10cf7f9c"
      ],
      "pair": "794dea7572afd8905c5f17544675ba71",
      "pays": {
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 656.3552271043033
      },
      "price": 0.693143955,
      "seq": 20870336,
      "side": "bid",
      "time": 1789975862000
    },
    {
      "_id": "r4hhiB3D7Ls3Pm77WdQTYHn1RN7VGufzeW_20862810",
      "account": "r4hhiB3D7Ls3Pm77WdQTYHn1RN7VGufzeW",
      "flags": 65536,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 16.258519
      },
      "hash": "4B579BBECE640AF6088A5AAE0C5BA1A6BA5E563D02B38757D6DC543A381E58EF",
      "ledger": 20929014,
      "md5": "12989284778980e987410b6e10cf7f9c",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "12989284778980e987410b6e10cf7f9c"
      ],
      "pair": "794dea7572afd8905c5f17544675ba71",
      "pays": {
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 23.47
      },
      "price": 0.6927362164465275,
      "seq": 20862810,
      "side": "bid",
      "time": 1789970662000
    },
    {
      "_id": "rsFjrRCwD79YiGcyE5Z5gRQtm684QFEmXa_20863931",
      "account": "rsFjrRCwD79YiGcyE5Z5gRQtm684QFEmXa",
      "flags": 65536,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 36.942533
      },
      "hash": "EC28ED0275E7B4D3F96CDF8AA9E6098D79283D4258C4552EBCE35376C0E8333C",
      "ledger": 20930090,
      "md5": "12989284778980e987410b6e10cf7f9c",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "12989284778980e987410b6e10cf7f9c"
      ],
      "pair": "794dea7572afd8905c5f17544675ba71",
      "pays": {
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 53.3447
      },
      "price": 0.6925248993808195,
      "seq": 20863931,
      "side": "bid",
      "time": 1789974361000
    },
    {
      "_id": "rwTmpajKfjQi4ZAqLc3wmBc8uPYq9LTHbN_20918800",
      "account": "rwTmpajKfjQi4ZAqLc3wmBc8uPYq9LTHbN",
      "expire": 1789979242000,
      "flags": 65536,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 26.565452
      },
      "hash": "7215E3CFF8EC8BFB403652F4BF9C8831A58C9B6B1847DF425BF38C16767ACD33",
      "ledger": 20930121,
      "md5": "12989284778980e987410b6e10cf7f9c",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "12989284778980e987410b6e10cf7f9c"
      ],
      "pair": "794dea7572afd8905c5f17544675ba71",
      "pays": {
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 38.3927
      },
      "price": 0.6919401865458799,
      "seq": 20918800,
      "side": "bid",
      "time": 1789974462000
    },
    {
      "_id": "rn7FXP3xHdangK8wofECWWz7r8KTaECXv2_20863874",
      "account": "rn7FXP3xHdangK8wofECWWz7r8KTaECXv2",
      "flags": 65536,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 37.551153
      },
      "hash": "60905794E33F491A7108AF0BDDDFB137BFF3D98A99C74CC9EF1C399C59D39EC2",
      "ledger": 20927945,
      "md5": "12989284778980e987410b6e10cf7f9c",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "12989284778980e987410b6e10cf7f9c"
      ],
      "pair": "794dea7572afd8905c5f17544675ba71",
      "pays": {
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 54.2899
      },
      "price": 0.6916784337418194,
      "seq": 20863874,
      "side": "bid",
      "time": 1789967060000
    }
  ],
  "asks": [
    {
      "_id": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP_20870338",
      "account": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
      "flags": 0,
      "gets": {
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 492.73774101431
      },
      "hash": "56FB305F5861C5A5C0A7962056E08F3691DFCB7D62DEC6DE5ADA869AB2CFBF7D",
      "ledger": 20930535,
      "md5": "12989284778980e987410b6e10cf7f9c",
      "md5s": [
        "12989284778980e987410b6e10cf7f9c",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "794dea7572afd8905c5f17544675ba71",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 342.973697
      },
      "price": 0.6960572906268193,
      "seq": 20870338,
      "side": "ask",
      "time": 1789975862000
    },
    {
      "_id": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP_20870331",
      "account": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
      "flags": 0,
      "gets": {
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 1924.34924060672
      },
      "hash": "616D50A319C445DE464F5B6354FC1D4EBF9445D70D23BB5E21815315A791CAF3",
      "ledger": 20930379,
      "md5": "12989284778980e987410b6e10cf7f9c",
      "md5s": [
        "12989284778980e987410b6e10cf7f9c",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "794dea7572afd8905c5f17544675ba71",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 1344.838719
      },
      "price": 0.6988537686516775,
      "seq": 20870331,
      "side": "ask",
      "time": 1789975322000
    },
    {
      "_id": "rBrwWHSqWy8UzdeQa5eeG5ninHVuYXWnnx_20919840",
      "account": "rBrwWHSqWy8UzdeQa5eeG5ninHVuYXWnnx",
      "flags": 65536,
      "gets": {
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 52.4946
      },
      "hash": "E5358AD53CCFD0CD34A1655C49CF7265FE437F8806E84A11D2062C64A3B48723",
      "ledger": 20930526,
      "md5": "12989284778980e987410b6e10cf7f9c",
      "md5s": [
        "12989284778980e987410b6e10cf7f9c",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "794dea7572afd8905c5f17544675ba71",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 36.727725
      },
      "price": 0.6996476780468848,
      "seq": 20919840,
      "side": "ask",
      "time": 1789975832000
    },
    {
      "_id": "rwTmpajKfjQi4ZAqLc3wmBc8uPYq9LTHbN_20918801",
      "account": "rwTmpajKfjQi4ZAqLc3wmBc8uPYq9LTHbN",
      "expire": 1789980157000,
      "flags": 65536,
      "gets": {
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 38.3927
      },
      "hash": "634AC177EF7BFB475441D614227DF45C98D1849408033D862F8F06EB2D378807",
      "ledger": 20930123,
      "md5": "12989284778980e987410b6e10cf7f9c",
      "md5s": [
        "12989284778980e987410b6e10cf7f9c",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "794dea7572afd8905c5f17544675ba71",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 26.912086
      },
      "price": 0.7009688300119554,
      "seq": 20918801,
      "side": "ask",
      "time": 1789974471000
    },
    {
      "_id": "r9WcMQkdF5LcagjMJtoMgkGr48pSkifj3W_20918161",
      "account": "r9WcMQkdF5LcagjMJtoMgkGr48pSkifj3W",
      "flags": 65536,
      "gets": {
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 40.5724
      },
      "hash": "8108674896CACCFFE281C972E4C797E1BE3A2BEE88DB3A371A9A0803A7C7DE08",
      "ledger": 20930123,
      "md5": "12989284778980e987410b6e10cf7f9c",
      "md5s": [
        "12989284778980e987410b6e10cf7f9c",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "794dea7572afd8905c5f17544675ba71",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 28.470937
      },
      "price": 0.701731645157792,
      "seq": 20918161,
      "side": "ask",
      "time": 1789974471000
    }
  ]
}

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. Testnet resets without warning; the data is rebuilt from the chain within minutes, and only objects touched since count. Open the Testnet sandbox →
OpenAPI
PrevGET/testnet/tokens/{md5}/holdersNextGET/testnet/tokens/{md5}/trades