GET /pairs/{id}
GET

/v1/pairs/{id}

Trading pairs for a specific token

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/pairs/0dd550278b74cb6690fdae351e8e0df3
Path parameterValueDescription
idA token id: its md5, slug or issuer_currency
curl 'https://api.xrpl.to/v1/pairs/0dd550278b74cb6690fdae351e8e0df3'

Response

200Example response84 ms · just now · 3.2 KB · 115 lines
https://api.xrpl.to/v1/pairs/0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "took": 81,
  "count": 100,
  "limit": 100,
  "truncated": true,
  "pairs": [
    {
      "_id": "4f192df9c8fb094ec93d87aa446fa161",
      "count": 12004,
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 1784943.0619613049,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "XRP",
        "issuer": null,
        "value": 1269704.327969,
        "md5": "eaf386fee7b02561c08cdbbac6b43a67",
        "name": "XRP"
      },
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "time": 1791766809936,
      "hasVolume": true,
      "id": 1
    },
    {
      "pair": "4ff0f02e4d99013b3a1e49918cace387",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 13985.389934851126,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "574C424E00000000000000000000000000000000",
        "issuer": "rDJz8WJhsKgydqJzSZXMpsJot3eRmSkR5",
        "value": 67856.7330221859,
        "md5": "2ae46a80e1b4fd9de138bcece532203a",
        "name": "WLBN"
      },
      "count": 7,
      "hasVolume": false,
      "time": 1791763741000,
      "id": 2
    },
    {
      "pair": "f5d1b703153b3f6be9afedd99a769a7a",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 12699.29720357192,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "BTC",
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
        "value": 0.1524736887990453,
        "md5": "ce7b81b078cf2c4f6391c39de3425e54",
        "name": "BTC"
      },
      "count": 51,
      "hasVolume": false,
      "time": 1791765041000,
      "id": 3
    },
    {
      "pair": "632f5266f831bfc7e3cbefe38daebee9",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 4920.545582161141,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "5553444300000000000000000000000000000000",
        "issuer": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE",
        "value": 4921.017532401894,
        "md5": "1c54f16ec1b45eef983f202b9954999b",
        "name": "USDC"
      },
      "count": 428,
      "hasVolume": false,
      "time": 1791766691000,
      "id": 4
    },
    {
      "pair": "71c9f2cb45e39d820a4f0088ca288c6f",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 4227.730682233509,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "ETH",
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
        "value": 1.669014909777162,
        "md5": "8c218f95e534dc05a9e906b3227c0213",
        "name": "ETH"
      },
      "count": 49,
      "hasVolume": false,
      "time": 1791765831000,
      "id": 5
    }
  ]
}

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

Shapeas documented
{
  success,
  took,
  count,
  limit: 100,
  truncated,
  pairs[]
}

What it does

Trading pairs for a specific token

A token id can be its md5, slug or issuer_currency. How to build an md5 →
OpenAPI