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 · 9.1 KB · 331 lines
https://api.xrpl.to/v1/traders/rotations/0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "period": "24h",
  "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
  "sellers": 321,
  "buyers": 339,
  "sellVolume": 3308723.3014789997,
  "buyVolume": 3292821.80932,
  "rotatedTo": [
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "xrp": 167598.94020942703,
      "traders": 27,
      "topTraders": [
        {
          "account": "rLVkkxk7THbb3dCZ6aETvLnzc8HabyubEs",
          "xrp": 85476.6941342986
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 62447.74889000002
        },
        {
          "account": "rGvKvNzPRpWSJSXMYXTQ3YVBtE6Zs6n8ro",
          "xrp": 13340.527557999998
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 1599.579225694617
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 753.3531701928998
        }
      ]
    },
    {
      "md5": "b05f7c8e58b832c74267d988567dea33",
      "name": "FUZZY",
      "currency": "46555A5A59000000000000000000000000000000",
      "slug": "rhCAT4hRdi2Y9puNdkpMzxrdKa5wkppR62-46555A5A59000000000000000000000000000000",
      "xrp": 8469.71139775687,
      "traders": 30,
      "topTraders": [
        {
          "account": "rsZ95urWjuKxzPWM17t5GdwribZgg5w4Cu",
          "xrp": 4470.60703752192
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 1365.2120230325772
        },
        {
          "account": "rxLfrvic9BP4atxcz433ZcdbHUknKFixM",
          "xrp": 1235.1911480944618
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 534.1615346224124
        },
        {
          "account": "rsFHoBianaFYifZo5fGAg8XMsqCugN7GZX",
          "xrp": 216.5698206520566
        }
      ]
    },
    {
      "md5": "3b46a51a490abb329e865dd778167256",
      "name": "BTC",
      "currency": "BTC",
      "slug": "rchGBxcD1A1C2tdxF6papQYZ8kjRKMYcL-BTC",
      "xrp": 5666.554791415327,
      "traders": 5,
      "topTraders": [
        {
          "account": "rBqUZzPRcVus1phirwuPd7f6QJQQsCdyax",
          "xrp": 5624.109054353193
        },
        {
          "account": "rMJ1ejWzy5AEF2tzFrv8FQpeR83DMLUQYq",
          "xrp": 39.93382390193614
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 1.6542739255923329
        },
        {
          "account": "rxLfrvic9BP4atxcz433ZcdbHUknKFixM",
          "xrp": 0.6930267789160538
        },
        {
          "account": "rh112ha3wQc3jJ8Ji7kheT8dJsQus9hRfJ",
          "xrp": 0.16461245568982386
        }
      ]
    },
    {
      "md5": "ce7b81b078cf2c4f6391c39de3425e54",
      "name": "BTC",
      "currency": "BTC",
      "slug": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B-BTC",
      "xrp": 5042.492765350637,
      "traders": 5,
      "topTraders": [
        {
          "account": "rBqUZzPRcVus1phirwuPd7f6QJQQsCdyax",
          "xrp": 2134.3596854846287
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 1673.2316935074173
        },
        {
          "account": "rMsXVzCug7nUsMYFGPXBTWY732fRZqxgfY",
          "xrp": 1128.837284
        },
        {
          "account": "rxLfrvic9BP4atxcz433ZcdbHUknKFixM",
          "xrp": 102.2793672573971
        },
        {
          "account": "r3ASEe1LLnhfCwrHKr4Cg6YS15t52S1MK5",
          "xrp": 3.7847351011938257
        }
      ]
    },
    {
      "md5": "96e1cb446d36e77e00e6f9ae2c833533",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rcEGREd8NmkKRE8GE424sksyt1tJVFZwu-5553444300000000000000000000000000000000",
      "xrp": 4118.373274762958,
      "traders": 3,
      "topTraders": [
        {
          "account": "rBYYcGkk4o98hdWvGiycAWMakMq4DKrWYw",
          "xrp": 4100.859982000001
        },
        {
          "account": "rEqYHwNakMkL5FVVewd1cBUNs6EphiNLNF",
          "xrp": 16.940793777116003
        },
        {
          "account": "rEtPBaAMLkukpsFGYtHt576xgiHfMCDtXD",
          "xrp": 0.5724989858421787
        }
      ]
    }
  ],
  "rotatedFrom": [
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "xrp": 167503.7383158475,
      "traders": 35,
      "topTraders": [
        {
          "account": "rLVkkxk7THbb3dCZ6aETvLnzc8HabyubEs",
          "xrp": 97802.34529011363
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 54937.240258999984
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 4030.7913307215795
        },
        {
          "account": "rahNQXNFYLZiqgjkMv9S728Ubu5PEn5BRT",
          "xrp": 1936.4241369551553
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 1625.7526297475683
        }
      ]
    },
    {
      "md5": "b05f7c8e58b832c74267d988567dea33",
      "name": "FUZZY",
      "currency": "46555A5A59000000000000000000000000000000",
      "slug": "rhCAT4hRdi2Y9puNdkpMzxrdKa5wkppR62-46555A5A59000000000000000000000000000000",
      "xrp": 6954.336529702982,
      "traders": 34,
      "topTraders": [
        {
          "account": "rsZ95urWjuKxzPWM17t5GdwribZgg5w4Cu",
          "xrp": 3916.6267219130605
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 976.4791208759087
        },
        {
          "account": "rKq7w4UwbudnWRvUcJJYR7kv6bJ8Dp2Axa",
          "xrp": 427.068262
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 415.6053993970181
        },
        {
          "account": "rxLfrvic9BP4atxcz433ZcdbHUknKFixM",
          "xrp": 393.07018131573295
        }
      ]
    },
    {
      "md5": "00d32006174e7600cb1451ae971e9443",
      "name": "TIME",
      "currency": "54494D4500000000000000000000000000000000",
      "slug": "rExSpmk2PAqxKRTT3mhjCrCpqVasBra5v8-54494D4500000000000000000000000000000000",
      "xrp": 4998.316105371978,
      "traders": 39,
      "topTraders": [
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 1720.219212259925
        },
        {
          "account": "rxLfrvic9BP4atxcz433ZcdbHUknKFixM",
          "xrp": 1388.9096300689935
        },
        {
          "account": "rsFHoBianaFYifZo5fGAg8XMsqCugN7GZX",
          "xrp": 818.741858
        },
        {
          "account": "r3ASEe1LLnhfCwrHKr4Cg6YS15t52S1MK5",
          "xrp": 159.51267812916046
        },
        {
          "account": "rsgVZcT7p8teo4gZV13JqoCui4S5LgHwm9",
          "xrp": 139.46587763979784
        }
      ]
    },
    {
      "md5": "a7cde93c44b168524a4de4de03750340",
      "name": "USD",
      "currency": "USD",
      "slug": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq-USD",
      "xrp": 4283.938600753112,
      "traders": 5,
      "topTraders": [
        {
          "account": "rL5GetGSnvorYFgM8c8G35b7mD8xcndjNk",
          "xrp": 3965.783591
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 184.3817843889991
        },
        {
          "account": "rEqYHwNakMkL5FVVewd1cBUNs6EphiNLNF",
          "xrp": 117.37348528448634
        },
        {
          "account": "rsPrWzpYp5jj278vHVgp1tMvbKdHAZGFbi",
          "xrp": 16.36865879736648
        },
        {
          "account": "rndHHQ1u3APjTfgBiaSrBE6mmrRT3qkyrg",
          "xrp": 0.031081282260653344
        }
      ]
    },
    {
      "md5": "c0088a2ab2bf8ba3484ec8164f018223",
      "name": "666",
      "currency": "666",
      "slug": "rhvf9fe6PP3GC8Bku2Ug7iQPjPDxYZfrxN-666",
      "xrp": 2258.4312022425465,
      "traders": 27,
      "topTraders": [
        {
          "account": "rGVGtQ2zzpNh9jgeNoXtZJ32mWbKi15CC7",
          "xrp": 1822.7548
        },
        {
          "account": "rxLfrvic9BP4atxcz433ZcdbHUknKFixM",
          "xrp": 148.68487788897104
        },
        {
          "account": "rBqUZzPRcVus1phirwuPd7f6QJQQsCdyax",
          "xrp": 135.25017645772755
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 54.61129180870738
        },
        {
          "account": "r3ASEe1LLnhfCwrHKr4Cg6YS15t52S1MK5",
          "xrp": 53.85495621977578
        }
      ]
    }
  ],
  "rotatedToTokens": 267,
  "rotatedFromTokens": 277,
  "freshCapital": [
    {
      "account": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "xrp": 389615.99471799977
    },
    {
      "account": "r3nVVxJfkdvjiXP1tov5pZdht96JMwGApP",
      "xrp": 285362.02945699997
    },
    {
      "account": "r3cpW3M3nKHfSgkJiEh1BaAy6GJXeZvMLU",
      "xrp": 183600.86199800018
    },
    {
      "account": "rKYdJJLAgxbJcn9Ria2X5jMMiqP91r4qy",
      "xrp": 178187.80099599992
    },
    {
      "account": "rpK3DLr8vDhPDGEPRKSjb65gdgehDga4ZZ",
      "xrp": 167469.13637299993
    }
  ],
  "freshCapitalTotal": 2320102.271221997,
  "freshCapitalCount": 216
}

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