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 response107 ms · just now · 3.2 KB · 115 lines
https://api.xrpl.to/v1/pairs?md5=0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "took": 104,
  "count": 100,
  "limit": 100,
  "truncated": true,
  "pairs": [
    {
      "_id": "4f192df9c8fb094ec93d87aa446fa161",
      "count": 23168,
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 3973764.064089482,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "XRP",
        "issuer": null,
        "value": 3109601.350246,
        "md5": "eaf386fee7b02561c08cdbbac6b43a67",
        "name": "XRP"
      },
      "pair": "4f192df9c8fb094ec93d87aa446fa161",
      "time": 1792392459425,
      "hasVolume": true,
      "id": 1
    },
    {
      "pair": "71c9f2cb45e39d820a4f0088ca288c6f",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 33140.48336298899,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "ETH",
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
        "value": 13.91966192915226,
        "md5": "8c218f95e534dc05a9e906b3227c0213",
        "name": "ETH"
      },
      "count": 109,
      "hasVolume": false,
      "time": 1792391170000,
      "id": 2
    },
    {
      "pair": "632f5266f831bfc7e3cbefe38daebee9",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 28772.575179009204,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "5553444300000000000000000000000000000000",
        "issuer": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE",
        "value": 28774.72224707965,
        "md5": "1c54f16ec1b45eef983f202b9954999b",
        "name": "USDC"
      },
      "count": 743,
      "hasVolume": false,
      "time": 1792392320000,
      "id": 3
    },
    {
      "pair": "f5d1b703153b3f6be9afedd99a769a7a",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 11228.48097153676,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "BTC",
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
        "value": 0.1380951741624257,
        "md5": "ce7b81b078cf2c4f6391c39de3425e54",
        "name": "BTC"
      },
      "count": 57,
      "hasVolume": false,
      "time": 1792381891000,
      "id": 4
    },
    {
      "pair": "b59226039b3eeaf56634c1b6b5d5d1d9",
      "curr1": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": 3673.0815829640323,
        "md5": "0dd550278b74cb6690fdae351e8e0df3",
        "name": "RLUSD"
      },
      "curr2": {
        "currency": "USD",
        "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y",
        "value": 3672.7087423546172,
        "md5": "fc6778be8e4ea99ba0bc508f6aef3b9c",
        "name": "USD"
      },
      "count": 374,
      "hasVolume": false,
      "time": 1792378200000,
      "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