XRPL.to
GET /traders/rotations/{tokenId}
GET

/v1/traders/rotations/{tokenId}

Trader rotations for a specific token

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/traders/rotations/0dd550278b74cb6690fdae351e8e0df3
Path parameterValueDescription
tokenIdA token id: its md5, slug or issuer_currency
Query parameterValueDescription
period24h|7d|30d (default 24h)
minXrpfloat (default 1)
curl 'https://api.xrpl.to/v1/traders/rotations/0dd550278b74cb6690fdae351e8e0df3'

Response

200Example response151 ms · just now · 8.9 KB · 331 lines
https://api.xrpl.to/v1/traders/rotations/0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "period": "24h",
  "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
  "sellers": 287,
  "buyers": 341,
  "sellVolume": 6407117.7851119945,
  "buyVolume": 6390417.770268992,
  "rotatedTo": [
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "xrp": 269048.73116256204,
      "traders": 29,
      "topTraders": [
        {
          "account": "rLtCVnojydtQy7GYGTmDegkM15hLX8VuZk",
          "xrp": 208735.66021764727
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 43633.036938
        },
        {
          "account": "rfcoGE3E59UcwJ7LUHmbRjGR5rWA8VQScB",
          "xrp": 6432.244646000001
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 4803.026367842139
        },
        {
          "account": "rDsxqzXUrmNs2jnqvG7pS2g2qA3x43uQyE",
          "xrp": 3022.5749872686883
        }
      ]
    },
    {
      "md5": "ce7b81b078cf2c4f6391c39de3425e54",
      "name": "BTC",
      "currency": "BTC",
      "slug": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B-BTC",
      "xrp": 10368.205992605137,
      "traders": 13,
      "topTraders": [
        {
          "account": "rLtCVnojydtQy7GYGTmDegkM15hLX8VuZk",
          "xrp": 8700.480162884995
        },
        {
          "account": "rDsxqzXUrmNs2jnqvG7pS2g2qA3x43uQyE",
          "xrp": 723.2665701614086
        },
        {
          "account": "rMsXVzCug7nUsMYFGPXBTWY732fRZqxgfY",
          "xrp": 412.520506
        },
        {
          "account": "rnGXnqQvMRS3FQmgzoL1ecU4sbtp9fDLfq",
          "xrp": 107.93353907341653
        },
        {
          "account": "rE18LjTqdzceyJpS3b2NnBJNujXTy5Yrie",
          "xrp": 102.58824182517822
        }
      ]
    },
    {
      "md5": "fc6778be8e4ea99ba0bc508f6aef3b9c",
      "name": "USD",
      "currency": "USD",
      "slug": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y-USD",
      "xrp": 2155.85071566118,
      "traders": 7,
      "topTraders": [
        {
          "account": "rDsxqzXUrmNs2jnqvG7pS2g2qA3x43uQyE",
          "xrp": 932.6037179772281
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 887.8001841403432
        },
        {
          "account": "rsPrWzpYp5jj278vHVgp1tMvbKdHAZGFbi",
          "xrp": 111.263921
        },
        {
          "account": "rBGkrD7LtLfcxmNWBHuNPcHh2pqNYUtxTM",
          "xrp": 99.55817182591905
        },
        {
          "account": "rGidge2jZYXk2vMy9yjEXyEx6JipQpaxek",
          "xrp": 63.14812111266141
        }
      ]
    },
    {
      "md5": "0f036e757e4aca67a2d4ae7aab638a95",
      "name": "CNY",
      "currency": "CNY",
      "slug": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y-CNY",
      "xrp": 1944.8021914257326,
      "traders": 12,
      "topTraders": [
        {
          "account": "rDsxqzXUrmNs2jnqvG7pS2g2qA3x43uQyE",
          "xrp": 614.8139934051696
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 595.7311934643334
        },
        {
          "account": "rBGkrD7LtLfcxmNWBHuNPcHh2pqNYUtxTM",
          "xrp": 196.0923667955687
        },
        {
          "account": "rsPrWzpYp5jj278vHVgp1tMvbKdHAZGFbi",
          "xrp": 169.70839
        },
        {
          "account": "rETH6BXQKkz2c1MmGbk5wNzn6vccq1ZhB1",
          "xrp": 158.61721288048548
        }
      ]
    },
    {
      "md5": "10738f460578b0d6c8414830d1f68f17",
      "name": "WETH",
      "currency": "5745544800000000000000000000000000000000",
      "slug": "rfmS3zqrQrka8wVyhXifEeyTwe8AMz2Yhw-5745544800000000000000000000000000000000",
      "xrp": 1852.6956450804557,
      "traders": 3,
      "topTraders": [
        {
          "account": "rLtCVnojydtQy7GYGTmDegkM15hLX8VuZk",
          "xrp": 1850.8246374677399
        },
        {
          "account": "r9tcGwSyYPyUNT3SmiY5KEH7KgmFs8SGrz",
          "xrp": 1.0416566094708093
        },
        {
          "account": "rDsxqzXUrmNs2jnqvG7pS2g2qA3x43uQyE",
          "xrp": 0.8293510032450337
        }
      ]
    }
  ],
  "rotatedFrom": [
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "xrp": 247609.91592735305,
      "traders": 75,
      "topTraders": [
        {
          "account": "rLtCVnojydtQy7GYGTmDegkM15hLX8VuZk",
          "xrp": 193501.49173924475
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 11152.152750460076
        },
        {
          "account": "rdHBiKxVC13zDAE9qQKGK8fsJub2t8rCe",
          "xrp": 8158.41348
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 7699.947938000001
        },
        {
          "account": "rDsxqzXUrmNs2jnqvG7pS2g2qA3x43uQyE",
          "xrp": 6610.843086547268
        }
      ]
    },
    {
      "md5": "ce7b81b078cf2c4f6391c39de3425e54",
      "name": "BTC",
      "currency": "BTC",
      "slug": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B-BTC",
      "xrp": 6559.04365358502,
      "traders": 5,
      "topTraders": [
        {
          "account": "rLtCVnojydtQy7GYGTmDegkM15hLX8VuZk",
          "xrp": 6476.5227329064455
        },
        {
          "account": "rBGkrD7LtLfcxmNWBHuNPcHh2pqNYUtxTM",
          "xrp": 32.81512670059977
        },
        {
          "account": "rETH6BXQKkz2c1MmGbk5wNzn6vccq1ZhB1",
          "xrp": 28.27166127684515
        },
        {
          "account": "rMsXVzCug7nUsMYFGPXBTWY732fRZqxgfY",
          "xrp": 18.85197
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 2.5821627011296564
        }
      ]
    },
    {
      "md5": "fc6778be8e4ea99ba0bc508f6aef3b9c",
      "name": "USD",
      "currency": "USD",
      "slug": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y-USD",
      "xrp": 2606.2761601329867,
      "traders": 8,
      "topTraders": [
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 1376.8157603543343
        },
        {
          "account": "rDsxqzXUrmNs2jnqvG7pS2g2qA3x43uQyE",
          "xrp": 424.9536997086224
        },
        {
          "account": "rBGkrD7LtLfcxmNWBHuNPcHh2pqNYUtxTM",
          "xrp": 319.9678062976172
        },
        {
          "account": "rETH6BXQKkz2c1MmGbk5wNzn6vccq1ZhB1",
          "xrp": 255.1836650894422
        },
        {
          "account": "rGidge2jZYXk2vMy9yjEXyEx6JipQpaxek",
          "xrp": 201.20613433113087
        }
      ]
    },
    {
      "md5": "33d41a287177d13f69da580dde9b968b",
      "name": "XAH",
      "currency": "XAH",
      "slug": "rswh1fvyLqHizBS2awu1vs6QcmwTBd9qiv-XAH",
      "xrp": 2370.088506159685,
      "traders": 10,
      "topTraders": [
        {
          "account": "rnCEEqDnCuSjDsHiJrca4VYUqaMyi4vGF7",
          "xrp": 1740.7141000000013
        },
        {
          "account": "rTeLeproT3BVgjWoYrDYpKbBLXPaVMkge",
          "xrp": 464.385696
        },
        {
          "account": "rMJtFvEVMf3u1fcdnX6NWTnbZT1Fzbca2b",
          "xrp": 40.150306
        },
        {
          "account": "rDsxqzXUrmNs2jnqvG7pS2g2qA3x43uQyE",
          "xrp": 27.4373579856317
        },
        {
          "account": "rETH6BXQKkz2c1MmGbk5wNzn6vccq1ZhB1",
          "xrp": 26.082425582549007
        }
      ]
    },
    {
      "md5": "233d2c15a1c1288bb65b318ab1846e58",
      "name": "DROP",
      "currency": "44524F5000000000000000000000000000000000",
      "slug": "rszenFJoDdiGjyezQc8pME9KWDQH43Tswh-44524F5000000000000000000000000000000000",
      "xrp": 2023.7157736251113,
      "traders": 26,
      "topTraders": [
        {
          "account": "r9ruWAaX3E4EDrMWgs7A7QbcvooMnHkaUd",
          "xrp": 598.5570429237148
        },
        {
          "account": "rDsxqzXUrmNs2jnqvG7pS2g2qA3x43uQyE",
          "xrp": 465.3282318813507
        },
        {
          "account": "rBqdTmz4g2LZSsY8mYt8rhwsqKbxVmhSxU",
          "xrp": 235.40640727256348
        },
        {
          "account": "rQJGHTJkoFvMh9VLQFiY8uSCoSoLL1jNwg",
          "xrp": 185.490949
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 125.59622277801276
        }
      ]
    }
  ],
  "rotatedToTokens": 202,
  "rotatedFromTokens": 240,
  "freshCapital": [
    {
      "account": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "xrp": 1226010.6009290004
    },
    {
      "account": "rKfa1JLEDBg3MJcs1Tozi3unKfU3PeZq5y",
      "xrp": 918945.8464050001
    },
    {
      "account": "rpK3DLr8vDhPDGEPRKSjb65gdgehDga4ZZ",
      "xrp": 398224.73785099987
    },
    {
      "account": "rKYdJJLAgxbJcn9Ria2X5jMMiqP91r4qy",
      "xrp": 387688.63017999957
    },
    {
      "account": "r3cpW3M3nKHfSgkJiEh1BaAy6GJXeZvMLU",
      "xrp": 381889.9500819999
    }
  ],
  "freshCapitalTotal": 5964749.640855996,
  "freshCapitalCount": 207
}

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

What it does

Trader rotations for a specific token

Notes
tokenId must be a raw md5 (no slug resolution)
A token id can be its md5, slug or issuer_currency. How to build an md5 →
OpenAPI
PrevGET/token/analytics/token/{id}/tradersNextPOST/dex/quote