GET /traders/rotations
GET

/v1/traders/rotations

Cross-token trader rotation analytics

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/traders/rotations
Query parameterValueDescription
period24h|7d|30d (default 24h)
minXrpfloat (default 1)
limitint (max 100, default 50)
curl 'https://api.xrpl.to/v1/traders/rotations'

Response

200Example response164 ms · just now · 7.0 KB · 204 lines
https://api.xrpl.to/v1/traders/rotations
{
  "success": true,
  "period": "24h",
  "totalRotators": 1099,
  "totalTokensInvolved": 574,
  "tokens": [
    {
      "md5": "0dd550278b74cb6690fdae351e8e0df3",
      "rotateInXrp": 6243027.191556994,
      "rotateOutXrp": 6217634.044321,
      "netFlow": 25393.147235994227,
      "rotateInTraders": 251,
      "rotateOutTraders": 209,
      "name": "RLUSD",
      "currency": "524C555344000000000000000000000000000000",
      "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000"
    },
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "rotateInXrp": 522223.3035229999,
      "rotateOutXrp": 495469.79049400025,
      "netFlow": 26753.513028999674,
      "rotateInTraders": 49,
      "rotateOutTraders": 89,
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000"
    },
    {
      "md5": "4bab2cf4289c4ae26d339aad41977248",
      "rotateInXrp": 155449.917499,
      "rotateOutXrp": 155449.917499,
      "netFlow": 0,
      "rotateInTraders": 2,
      "rotateOutTraders": 2,
      "name": "USDV",
      "currency": "5553445600000000000000000000000000000000",
      "slug": "rfffsukWALJB1PXYk7H8xkR6UJUDT8nMJE-5553445600000000000000000000000000000000"
    },
    {
      "md5": "d45be5df0a4aed992d9278a4c5bdf5e0",
      "rotateInXrp": 26585.870662000005,
      "rotateOutXrp": 26604.870662000005,
      "netFlow": -19,
      "rotateInTraders": 3,
      "rotateOutTraders": 3,
      "name": "QUWAGI",
      "currency": "5155574147490000000000000000000000000000",
      "slug": "r4d5pc8RYorPE1NteKVkSGpNKUztagizA9-5155574147490000000000000000000000000000"
    },
    {
      "md5": "cd9499746c1b2e041563a9724330b3e6",
      "rotateInXrp": 22565.158631,
      "rotateOutXrp": 23566.433287999997,
      "netFlow": -1001.2746569999981,
      "rotateInTraders": 48,
      "rotateOutTraders": 57,
      "name": "ARMY",
      "currency": "41524D5900000000000000000000000000000000",
      "slug": "rGG3wQ4kUzd7Jnmk1n5NWPZjjut62kCBfC-41524D5900000000000000000000000000000000"
    }
  ],
  "topRotators": [
    {
      "account": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "totalVolume": 2454955.0246579996,
      "tokenCount": 1,
      "topTokens": [
        {
          "md5": "0dd550278b74cb6690fdae351e8e0df3",
          "name": "RLUSD",
          "currency": "524C555344000000000000000000000000000000",
          "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
          "direction": "buy",
          "buyXrp": 1227966.9723800004
        },
        {
          "md5": "0dd550278b74cb6690fdae351e8e0df3",
          "name": "RLUSD",
          "currency": "524C555344000000000000000000000000000000",
          "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
          "direction": "sell",
          "sellXrp": 1226988.0522779992
        }
      ]
    },
    {
      "account": "rKfa1JLEDBg3MJcs1Tozi3unKfU3PeZq5y",
      "totalVolume": 1852406.1055790002,
      "tokenCount": 1,
      "topTokens": [
        {
          "md5": "0dd550278b74cb6690fdae351e8e0df3",
          "name": "RLUSD",
          "currency": "524C555344000000000000000000000000000000",
          "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
          "direction": "buy",
          "buyXrp": 918945.8464050001
        },
        {
          "md5": "0dd550278b74cb6690fdae351e8e0df3",
          "name": "RLUSD",
          "currency": "524C555344000000000000000000000000000000",
          "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
          "direction": "sell",
          "sellXrp": 933460.2591740001
        }
      ]
    },
    {
      "account": "rLtCVnojydtQy7GYGTmDegkM15hLX8VuZk",
      "totalVolume": 889830.807235,
      "tokenCount": 4,
      "topTokens": [
        {
          "md5": "1c54f16ec1b45eef983f202b9954999b",
          "name": "USDC",
          "currency": "5553444300000000000000000000000000000000",
          "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
          "direction": "buy",
          "buyXrp": 221468.475565
        },
        {
          "md5": "0dd550278b74cb6690fdae351e8e0df3",
          "name": "RLUSD",
          "currency": "524C555344000000000000000000000000000000",
          "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
          "direction": "buy",
          "buyXrp": 201615.33532699995
        },
        {
          "md5": "ce7b81b078cf2c4f6391c39de3425e54",
          "name": "BTC",
          "currency": "BTC",
          "slug": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B-BTC",
          "direction": "buy",
          "buyXrp": 9287.929360000002
        },
        {
          "md5": "0dd550278b74cb6690fdae351e8e0df3",
          "name": "RLUSD",
          "currency": "524C555344000000000000000000000000000000",
          "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
          "direction": "sell",
          "sellXrp": 223884.215018
        },
        {
          "md5": "1c54f16ec1b45eef983f202b9954999b",
          "name": "USDC",
          "currency": "5553444300000000000000000000000000000000",
          "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
          "direction": "sell",
          "sellXrp": 222379.184288
        }
      ]
    },
    {
      "account": "rpK3DLr8vDhPDGEPRKSjb65gdgehDga4ZZ",
      "totalVolume": 811333.1040489997,
      "tokenCount": 1,
      "topTokens": [
        {
          "md5": "0dd550278b74cb6690fdae351e8e0df3",
          "name": "RLUSD",
          "currency": "524C555344000000000000000000000000000000",
          "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
          "direction": "buy",
          "buyXrp": 398862.42785099987
        },
        {
          "md5": "0dd550278b74cb6690fdae351e8e0df3",
          "name": "RLUSD",
          "currency": "524C555344000000000000000000000000000000",
          "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
          "direction": "sell",
          "sellXrp": 412470.6761979999
        }
      ]
    },
    {
      "account": "r3cpW3M3nKHfSgkJiEh1BaAy6GJXeZvMLU",
      "totalVolume": 783809.9684329997,
      "tokenCount": 1,
      "topTokens": [
        {
          "md5": "0dd550278b74cb6690fdae351e8e0df3",
          "name": "RLUSD",
          "currency": "524C555344000000000000000000000000000000",
          "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
          "direction": "buy",
          "buyXrp": 384867.5053689999
        },
        {
          "md5": "0dd550278b74cb6690fdae351e8e0df3",
          "name": "RLUSD",
          "currency": "524C555344000000000000000000000000000000",
          "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
          "direction": "sell",
          "sellXrp": 398942.4630639998
        }
      ]
    }
  ]
}

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

What it does

Cross-token trader rotation analytics

Each token comes back with its md5, the id every Token endpoint takes. Go to Token →
OpenAPI