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 response1 ms · just now · 8.4 KB · 319 lines
https://api.xrpl.to/v1/traders/rotations/0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "period": "24h",
  "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
  "sellers": 239,
  "buyers": 284,
  "sellVolume": 1242431.182195,
  "buyVolume": 1237823.865616,
  "rotatedTo": [
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "xrp": 55284.9482776305,
      "traders": 25,
      "topTraders": [
        {
          "account": "rLVkkxk7THbb3dCZ6aETvLnzc8HabyubEs",
          "xrp": 35199.17307900001
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 16130.434816000003
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 931.3773075405123
        },
        {
          "account": "r3ASEe1LLnhfCwrHKr4Cg6YS15t52S1MK5",
          "xrp": 693.2180091237212
        },
        {
          "account": "rsZ95urWjuKxzPWM17t5GdwribZgg5w4Cu",
          "xrp": 649.519938
        }
      ]
    },
    {
      "md5": "3b46a51a490abb329e865dd778167256",
      "name": "BTC",
      "currency": "BTC",
      "slug": "rchGBxcD1A1C2tdxF6papQYZ8kjRKMYcL-BTC",
      "xrp": 4600.742140390579,
      "traders": 10,
      "topTraders": [
        {
          "account": "r3A7H91Er71o1V5CPwaDSMfQBEH6SHoVu8",
          "xrp": 3418.462657
        },
        {
          "account": "rGUZQP9cyMzr2iMLMgof5w36QwQKvN5mBU",
          "xrp": 1153.5409178528441
        },
        {
          "account": "rMJ1ejWzy5AEF2tzFrv8FQpeR83DMLUQYq",
          "xrp": 21.459016
        },
        {
          "account": "r3RPoMvzi896yY25YY3YD16geAkcwbE82F",
          "xrp": 3.8118353923736485
        },
        {
          "account": "rBmrompqQ2nqcY5BFrAfwWdAsNNLG5eot4",
          "xrp": 2.533242130670691
        }
      ]
    },
    {
      "md5": "9b4ddc2e62f736881eef8f9f02812dbc",
      "name": "SHX",
      "currency": "SHX",
      "slug": "rfmS3zqrQrka8wVyhXifEeyTwe8AMz2Yhw-SHX",
      "xrp": 3907.267654536757,
      "traders": 7,
      "topTraders": [
        {
          "account": "rLFpNiNe4KDBuJQPmJi9dAdho271QmUK8b",
          "xrp": 2962.87113
        },
        {
          "account": "rHxcnfnxwQyDCGpKssdzwzB7i7UdxH1bng",
          "xrp": 574.4951229999999
        },
        {
          "account": "rsau42a7p3BbrVvivGcfTPmH2fR74VRdY7",
          "xrp": 358.641054
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 5.4825127406556025
        },
        {
          "account": "r3ASEe1LLnhfCwrHKr4Cg6YS15t52S1MK5",
          "xrp": 4.419857113411041
        }
      ]
    },
    {
      "md5": "a7cde93c44b168524a4de4de03750340",
      "name": "USD",
      "currency": "USD",
      "slug": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq-USD",
      "xrp": 1538.7166828030252,
      "traders": 6,
      "topTraders": [
        {
          "account": "rL5GetGSnvorYFgM8c8G35b7mD8xcndjNk",
          "xrp": 1527.8261949999996
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 4.850644873294527
        },
        {
          "account": "rBmrompqQ2nqcY5BFrAfwWdAsNNLG5eot4",
          "xrp": 4.5763557967411455
        },
        {
          "account": "rBkmbRkVMv8fg8ykHrokYy2h21Fgv71Szf",
          "xrp": 1.3021531520262208
        },
        {
          "account": "rBGkrD7LtLfcxmNWBHuNPcHh2pqNYUtxTM",
          "xrp": 0.13776251965584146
        }
      ]
    },
    {
      "md5": "ce7b81b078cf2c4f6391c39de3425e54",
      "name": "BTC",
      "currency": "BTC",
      "slug": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B-BTC",
      "xrp": 1065.4204783539296,
      "traders": 4,
      "topTraders": [
        {
          "account": "rMsXVzCug7nUsMYFGPXBTWY732fRZqxgfY",
          "xrp": 1023.3205689999999
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 25.835575
        },
        {
          "account": "rKQCiWXtSXiNBoARK5pob2nmRNSNxoduqr",
          "xrp": 11.420413
        },
        {
          "account": "rBqUZzPRcVus1phirwuPd7f6QJQQsCdyax",
          "xrp": 4.843921353929616
        }
      ]
    }
  ],
  "rotatedFrom": [
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "xrp": 27755.65550921448,
      "traders": 19,
      "topTraders": [
        {
          "account": "rLVkkxk7THbb3dCZ6aETvLnzc8HabyubEs",
          "xrp": 18272.18523807123
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 6884.325779000001
        },
        {
          "account": "rPLrQP7Fmauk7vmVSt31mj2yGZrX31Xo6k",
          "xrp": 502.8996035290906
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 374.3777265781226
        },
        {
          "account": "rBqUZzPRcVus1phirwuPd7f6QJQQsCdyax",
          "xrp": 344.100785011968
        }
      ]
    },
    {
      "md5": "33d41a287177d13f69da580dde9b968b",
      "name": "XAH",
      "currency": "XAH",
      "slug": "rswh1fvyLqHizBS2awu1vs6QcmwTBd9qiv-XAH",
      "xrp": 2027.6406329106364,
      "traders": 14,
      "topTraders": [
        {
          "account": "rnCEEqDnCuSjDsHiJrca4VYUqaMyi4vGF7",
          "xrp": 1302.7131679999998
        },
        {
          "account": "rTeLeproT3BVgjWoYrDYpKbBLXPaVMkge",
          "xrp": 494.775556
        },
        {
          "account": "rMJ1ejWzy5AEF2tzFrv8FQpeR83DMLUQYq",
          "xrp": 137.1813699085483
        },
        {
          "account": "rodv7iBHhANoeuGpkzYcZHxx6LUaGfQbv",
          "xrp": 48.59991
        },
        {
          "account": "rhxXuUBjYoDcL4EfZMp6kyo8amr6E9c5j9",
          "xrp": 19.78015
        }
      ]
    },
    {
      "md5": "9b4ddc2e62f736881eef8f9f02812dbc",
      "name": "SHX",
      "currency": "SHX",
      "slug": "rfmS3zqrQrka8wVyhXifEeyTwe8AMz2Yhw-SHX",
      "xrp": 1803.994782523864,
      "traders": 18,
      "topTraders": [
        {
          "account": "rsau42a7p3BbrVvivGcfTPmH2fR74VRdY7",
          "xrp": 1079.080469
        },
        {
          "account": "rHxcnfnxwQyDCGpKssdzwzB7i7UdxH1bng",
          "xrp": 475.406094
        },
        {
          "account": "rLFpNiNe4KDBuJQPmJi9dAdho271QmUK8b",
          "xrp": 215.007362
        },
        {
          "account": "rBqUZzPRcVus1phirwuPd7f6QJQQsCdyax",
          "xrp": 16.255685810233295
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 7.576523316041361
        }
      ]
    },
    {
      "md5": "a7cde93c44b168524a4de4de03750340",
      "name": "USD",
      "currency": "USD",
      "slug": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq-USD",
      "xrp": 1670.9663424181967,
      "traders": 6,
      "topTraders": [
        {
          "account": "rL5GetGSnvorYFgM8c8G35b7mD8xcndjNk",
          "xrp": 1625
        },
        {
          "account": "rBqUZzPRcVus1phirwuPd7f6QJQQsCdyax",
          "xrp": 25.12350228695062
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 16.370095282897132
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 3.6836475250143135
        },
        {
          "account": "rhUvv3UU894VkVacnnGvSGWjffj59c8VUT",
          "xrp": 0.5287077637706964
        }
      ]
    },
    {
      "md5": "f11136efc04c5c1ccf1445a0831b323f",
      "name": "XAGa",
      "currency": "5841476100000000000000000000000000000000",
      "slug": "rQJ1EbtepKKzx4sBCUtPjvSk8CfiAx2H8e-5841476100000000000000000000000000000000",
      "xrp": 990.01485,
      "traders": 1,
      "topTraders": [
        {
          "account": "rBH6NbPXMDU9AMMUBQTRsn6bkWdbKbRSQD",
          "xrp": 990.01485
        }
      ]
    }
  ],
  "rotatedToTokens": 175,
  "rotatedFromTokens": 185,
  "freshCapital": [
    {
      "account": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "xrp": 131838.12441499997
    },
    {
      "account": "rKYdJJLAgxbJcn9Ria2X5jMMiqP91r4qy",
      "xrp": 61614.795900000005
    },
    {
      "account": "rai4ovpdYhkdSNMNgX9hJkBRMwXf7nkyTJ",
      "xrp": 60461.838537
    },
    {
      "account": "rDi2VysuPsU5oQRGPDTPiR9YPd34kzK9m8",
      "xrp": 60443.771856999985
    },
    {
      "account": "r3nVVxJfkdvjiXP1tov5pZdht96JMwGApP",
      "xrp": 59406.47545299997
    }
  ],
  "freshCapitalTotal": 976821.4261140004,
  "freshCapitalCount": 193
}

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