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

Request

GEThttps://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/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/2b5e3c50d0500edf86212000b9883dce/offers'

Response

200Example response13 ms · just now · 8.0 KB · 271 lines

https://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/offers

{
  "success": true,
  "took": 3,
  "limit": 50,
  "bids": [
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21953890",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 566.511873
      },
      "hash": "81C03F0F958B0AFC8B8CB2EC6CDEAF67FE4F8873B594276E2E9A1BC92197497D",
      "ledger": 21981606,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "2b5e3c50d0500edf86212000b9883dce"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 711.8369935741691
      },
      "price": 0.795844945,
      "seq": 21953890,
      "side": "bid",
      "time": 1793516762000
    },
    {
      "_id": "raR886T4X9TqihhqSaSPaphXAqqgpMEqeB_21955407",
      "account": "raR886T4X9TqihhqSaSPaphXAqqgpMEqeB",
      "expire": 1793523562000,
      "flags": 65536,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 7.969812
      },
      "hash": "0DE551B7C42247A91BAB22213F336F2E6249A30E44B3A3FF5BB3B0430F2566FB",
      "ledger": 21981599,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "2b5e3c50d0500edf86212000b9883dce"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 10.0381
      },
      "price": 0.7939562267759835,
      "seq": 21955407,
      "side": "bid",
      "time": 1793516740000
    },
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21953864",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 1584.253097
      },
      "hash": "80B19B1A644C4F18BDE9303465CEB79A9B01EB1B6FCCED03C5D1EF7B6FA66394",
      "ledger": 21980648,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "2b5e3c50d0500edf86212000b9883dce"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 2000
      },
      "price": 0.7921265485,
      "seq": 21953864,
      "side": "bid",
      "time": 1793513410000
    },
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21953224",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 3154.018571
      },
      "hash": "FA708A31AA857103C39D71354BF627563DE000D31E18A41C5AC325636874A448",
      "ledger": 21955968,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "84e5efeb89c4eae8f68188982dc290d8",
        "2b5e3c50d0500edf86212000b9883dce"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 4000
      },
      "price": 0.78850464275,
      "seq": 21953224,
      "side": "bid",
      "time": 1793426812000
    }
  ],
  "asks": [
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21953889",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 638.9770704850033
      },
      "hash": "E3B569987B3B137524F3FDC2E57279BEA24FE73DA54C7AB8513ED1EBA1C7B0FE",
      "ledger": 21981606,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 511.075677
      },
      "price": 0.7998341421110429,
      "seq": 21953889,
      "side": "ask",
      "time": 1793516762000
    },
    {
      "_id": "r453rpyijXZ3S8qpXb1G1bRZq8TRAiFaaW_21955471",
      "account": "r453rpyijXZ3S8qpXb1G1bRZq8TRAiFaaW",
      "flags": 65536,
      "gets": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 33.7603
      },
      "hash": "8258016D67BB0B1D2902531EB634BBFBEE211BB184DBB179ADF3A47881AEB376",
      "ledger": 21981601,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 27.101093
      },
      "price": 0.8027503606306816,
      "seq": 21955471,
      "side": "ask",
      "time": 1793516742000
    },
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21953856",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 2000
      },
      "hash": "85CE47E507A285AE0B01D21384C1D1E850B48DB0A8C0C2614B68C51DC49B6376",
      "ledger": 21980303,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 1605.554004
      },
      "price": 0.802777002,
      "seq": 21953856,
      "side": "ask",
      "time": 1793512211000
    },
    {
      "_id": "raR886T4X9TqihhqSaSPaphXAqqgpMEqeB_21955408",
      "account": "raR886T4X9TqihhqSaSPaphXAqqgpMEqeB",
      "flags": 65536,
      "gets": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 10.0381
      },
      "hash": "C7F0F074EC458D5F681ECFACACC6268EF030F4064573D80B871E14B2BFF1C33A",
      "ledger": 21981601,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 8.079984
      },
      "price": 0.8049316105637521,
      "seq": 21955408,
      "side": "ask",
      "time": 1793516742000
    },
    {
      "_id": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7_21953504",
      "account": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "flags": 0,
      "gets": {
        "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
        "currency": "524C555344000000000000000000000000000000",
        "name": "RLUSD",
        "value": 4000
      },
      "hash": "822801E5D8FDA9862BF6BDAA6932310250E4F6568FB218661EE080C8B8729897",
      "ledger": 21966779,
      "md5": "2b5e3c50d0500edf86212000b9883dce",
      "md5s": [
        "2b5e3c50d0500edf86212000b9883dce",
        "84e5efeb89c4eae8f68188982dc290d8"
      ],
      "pair": "e72c2c7d6a5225b7c4927c717a6c8d25",
      "pays": {
        "issuer": "XRPL",
        "currency": "XRP",
        "name": "XRP",
        "value": 3236.452339
      },
      "price": 0.80911308475,
      "seq": 21953504,
      "side": "ask",
      "time": 1793464810000
    }
  ]
}

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