GET /pairs
GET

/v1/pairs

Trading pairs for a token

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/pairs?md5=0dd550278b74cb6690fdae351e8e0df3
Query parameterValueDescription
md5token id (required)
curl 'https://api.xrpl.to/v1/pairs?md5=0dd550278b74cb6690fdae351e8e0df3'

Response

200Example response119 ms · just now · 3.2 KB · 115 lines
https://api.xrpl.to/v1/pairs?md5=0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "took": 115,
  "count": 100,
  "limit": 100,
  "truncated": true,
  "pairs": [
    {
      "_id": "4f192df9c8fb094ec93d87aa446fa161",
      "count": 24961,
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 6642599.748851762,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "XRP",
        "issuer": null,
        "value": 4705750.979735,
        "md5": "eaf386fee7b02561c08cdbbac6b43a67",
        "name": "XRP"
      },
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "time": 1789975778629,
      "hasVolume": true,
      "id": 1
    },
    {
      "pair": "632f5266f831bfc7e3cbefe38daebee9",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 38659.50525523011,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "5553444300000000000000000000000000000000",
        "issuer": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE",
        "value": 38660.41230338668,
        "md5": "1c54f16ec1b45eef983f202b9954999b",
        "name": "USDC"
      },
      "count": 1228,
      "hasVolume": false,
      "time": 1789975312000,
      "id": 2
    },
    {
      "pair": "71c9f2cb45e39d820a4f0088ca288c6f",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 33484.72078124517,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "ETH",
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
        "value": 12.633681139985853,
        "md5": "8c218f95e534dc05a9e906b3227c0213",
        "name": "ETH"
      },
      "count": 67,
      "hasVolume": false,
      "time": 1789966560000,
      "id": 3
    },
    {
      "pair": "f5d1b703153b3f6be9afedd99a769a7a",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 8518.727388195884,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "BTC",
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
        "value": 0.1043255016523636,
        "md5": "ce7b81b078cf2c4f6391c39de3425e54",
        "name": "BTC"
      },
      "count": 39,
      "hasVolume": false,
      "time": 1789975320000,
      "id": 4
    },
    {
      "pair": "b59226039b3eeaf56634c1b6b5d5d1d9",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 3237.9216943098922,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "USD",
        "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y",
        "value": 3233.1016968972417,
        "md5": "fc6778be8e4ea99ba0bc508f6aef3b9c",
        "name": "USD"
      },
      "count": 323,
      "hasVolume": false,
      "time": 1789975470000,
      "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 token

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