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 response184 ms · just now · 9.1 KB · 339 lines
https://api.xrpl.to/v1/traders/rotations/0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "period": "24h",
  "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
  "sellers": 515,
  "buyers": 440,
  "sellVolume": 18594705.135602,
  "buyVolume": 18625571.956882004,
  "rotatedTo": [
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "xrp": 1379634.9398331693,
      "traders": 85,
      "topTraders": [
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 535347.0706670001
        },
        {
          "account": "rLVkkxk7THbb3dCZ6aETvLnzc8HabyubEs",
          "xrp": 489977.5119867081
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 139126.7492385428
        },
        {
          "account": "rGvKvNzPRpWSJSXMYXTQ3YVBtE6Zs6n8ro",
          "xrp": 43295.038388
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 39875.54284555611
        }
      ]
    },
    {
      "md5": "ce7b81b078cf2c4f6391c39de3425e54",
      "name": "BTC",
      "currency": "BTC",
      "slug": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B-BTC",
      "xrp": 19860.68263942442,
      "traders": 23,
      "topTraders": [
        {
          "account": "rMsXVzCug7nUsMYFGPXBTWY732fRZqxgfY",
          "xrp": 11276.385254000003
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 2454.871677
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 1907.1663974623777
        },
        {
          "account": "rEYLNoaQM5bCMUNhrsvMasTMQ1YgZz5hzT",
          "xrp": 1405.1524355047638
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 1032.0264170906844
        }
      ]
    },
    {
      "md5": "a7cde93c44b168524a4de4de03750340",
      "name": "USD",
      "currency": "USD",
      "slug": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq-USD",
      "xrp": 16742.31494921201,
      "traders": 18,
      "topTraders": [
        {
          "account": "rL5GetGSnvorYFgM8c8G35b7mD8xcndjNk",
          "xrp": 13834.743868
        },
        {
          "account": "rwG5huGCbXUGsB3NXJQ4A8tdny4rax5iEa",
          "xrp": 1143.311953259455
        },
        {
          "account": "ra3wYLE4HXjQM6uo96TahVhvtMy87xyS4F",
          "xrp": 914.7574372441165
        },
        {
          "account": "rEYLNoaQM5bCMUNhrsvMasTMQ1YgZz5hzT",
          "xrp": 597.2767489292759
        },
        {
          "account": "rP4gybHF3astaSuih16DMpL16aFa6DjYkX",
          "xrp": 118.10146830000238
        }
      ]
    },
    {
      "md5": "0f036e757e4aca67a2d4ae7aab638a95",
      "name": "CNY",
      "currency": "CNY",
      "slug": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y-CNY",
      "xrp": 14463.307648784705,
      "traders": 40,
      "topTraders": [
        {
          "account": "rJF4MfEjjt8BQ8Xt5kzKBTVofPCKG1yqJ8",
          "xrp": 2550.0304891069122
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 2194.309594918945
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 2139.717758033519
        },
        {
          "account": "rfU3YWd1TnYryvryQTQ9xwyCSqzMTbnyW6",
          "xrp": 1995.739877
        },
        {
          "account": "rxLfrvic9BP4atxcz433ZcdbHUknKFixM",
          "xrp": 1420.5275789940722
        }
      ]
    },
    {
      "md5": "2ae46a80e1b4fd9de138bcece532203a",
      "name": "WLBN",
      "currency": "574C424E00000000000000000000000000000000",
      "slug": "rDJz8WJhsKgydqJzSZXMpsJot3eRmSkR5-574C424E00000000000000000000000000000000",
      "xrp": 13721.25702391945,
      "traders": 23,
      "topTraders": [
        {
          "account": "rMeMqU7miMwgEfZKp8KW3d4MXjcF7qGobh",
          "xrp": 10886.798232
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 555.9732586015787
        },
        {
          "account": "rJF4MfEjjt8BQ8Xt5kzKBTVofPCKG1yqJ8",
          "xrp": 419.9224694023336
        },
        {
          "account": "rNBHzaCoZ236D2cCEpzATuFSbQLgL89ApB",
          "xrp": 372.8584712898548
        },
        {
          "account": "rPQy9Ube89YXxocshuoVG21mLWR1ZT8tjk",
          "xrp": 341.7371376050325
        }
      ]
    }
  ],
  "rotatedFrom": [
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "xrp": 1317582.1201650866,
      "traders": 88,
      "topTraders": [
        {
          "account": "rLVkkxk7THbb3dCZ6aETvLnzc8HabyubEs",
          "xrp": 530267.2509414701
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 440894.79459400004
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 88762.23207916538
        },
        {
          "account": "rGvKvNzPRpWSJSXMYXTQ3YVBtE6Zs6n8ro",
          "xrp": 84978.85418180017
        },
        {
          "account": "rEYLNoaQM5bCMUNhrsvMasTMQ1YgZz5hzT",
          "xrp": 62121.95706883271
        }
      ]
    },
    {
      "md5": "0f036e757e4aca67a2d4ae7aab638a95",
      "name": "CNY",
      "currency": "CNY",
      "slug": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y-CNY",
      "xrp": 20136.945640320646,
      "traders": 42,
      "topTraders": [
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 4274.377759622657
        },
        {
          "account": "rdHBiKxVC13zDAE9qQKGK8fsJub2t8rCe",
          "xrp": 3827.2218965222196
        },
        {
          "account": "rwG5huGCbXUGsB3NXJQ4A8tdny4rax5iEa",
          "xrp": 2702.328287460837
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 2092.940672101432
        },
        {
          "account": "rsPrWzpYp5jj278vHVgp1tMvbKdHAZGFbi",
          "xrp": 1160.833470790671
        }
      ]
    },
    {
      "md5": "ce7b81b078cf2c4f6391c39de3425e54",
      "name": "BTC",
      "currency": "BTC",
      "slug": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B-BTC",
      "xrp": 13999.965777330692,
      "traders": 20,
      "topTraders": [
        {
          "account": "rMsXVzCug7nUsMYFGPXBTWY732fRZqxgfY",
          "xrp": 5329.898413
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 2665.9622081169127
        },
        {
          "account": "rNBHzaCoZ236D2cCEpzATuFSbQLgL89ApB",
          "xrp": 1593.3909970380105
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 1221.701407
        },
        {
          "account": "rEYLNoaQM5bCMUNhrsvMasTMQ1YgZz5hzT",
          "xrp": 845.0815083667978
        }
      ]
    },
    {
      "md5": "b05f7c8e58b832c74267d988567dea33",
      "name": "FUZZY",
      "currency": "46555A5A59000000000000000000000000000000",
      "slug": "rhCAT4hRdi2Y9puNdkpMzxrdKa5wkppR62-46555A5A59000000000000000000000000000000",
      "xrp": 13929.69930301473,
      "traders": 52,
      "topTraders": [
        {
          "account": "rMtrM365J1BZSfS9SmPXFKbWXE8iwVs7k1",
          "xrp": 3847.1813608871485
        },
        {
          "account": "rJ1L8HuHd5rjU3QtW9BtR3EzJ2GVr2rpFL",
          "xrp": 2828.514345
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 2345.78303820302
        },
        {
          "account": "rnmxXo6YDKy2DJf6KSkfbXKDfGFSdAyG89",
          "xrp": 2333.5817319999996
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 536.2433357771332
        }
      ]
    },
    {
      "md5": "33d41a287177d13f69da580dde9b968b",
      "name": "XAH",
      "currency": "XAH",
      "slug": "rswh1fvyLqHizBS2awu1vs6QcmwTBd9qiv-XAH",
      "xrp": 12706.423377358004,
      "traders": 54,
      "topTraders": [
        {
          "account": "rnCEEqDnCuSjDsHiJrca4VYUqaMyi4vGF7",
          "xrp": 4588.926844
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 3124.7637042045994
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 962.8479948775291
        },
        {
          "account": "rEHG7rnKd7wP7gBZEL88jQRGwwp1ZpNc2D",
          "xrp": 937.337724
        },
        {
          "account": "rJF4MfEjjt8BQ8Xt5kzKBTVofPCKG1yqJ8",
          "xrp": 623.1123851240548
        }
      ]
    }
  ],
  "rotatedToTokens": 310,
  "rotatedFromTokens": 281,
  "freshCapital": [
    {
      "account": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "xrp": 2946898.569667004
    },
    {
      "account": "r3nVVxJfkdvjiXP1tov5pZdht96JMwGApP",
      "xrp": 1461033.6802679999
    },
    {
      "account": "rpK3DLr8vDhPDGEPRKSjb65gdgehDga4ZZ",
      "xrp": 838582.7897830005
    },
    {
      "account": "rDi2VysuPsU5oQRGPDTPiR9YPd34kzK9m8",
      "xrp": 709409.0119700001
    },
    {
      "account": "rKYdJJLAgxbJcn9Ria2X5jMMiqP91r4qy",
      "xrp": 704265.5413370002
    }
  ],
  "freshCapitalTotal": 14750597.893795995,
  "freshCapitalCount": 277
}

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