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 · 335 lines
https://api.xrpl.to/v1/traders/rotations/0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "period": "24h",
  "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
  "sellers": 214,
  "buyers": 237,
  "sellVolume": 911883.7837970008,
  "buyVolume": 912058.3942460001,
  "rotatedTo": [
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "xrp": 16982.910156553407,
      "traders": 42,
      "topTraders": [
        {
          "account": "rLVkkxk7THbb3dCZ6aETvLnzc8HabyubEs",
          "xrp": 14071.702015727147
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 921.452414
        },
        {
          "account": "rBWr5wTBJhc5osje2PcRZkaWFcamqjnDBG",
          "xrp": 286.0635790000002
        },
        {
          "account": "rGAs3npYy1VwLPE92kvKvA2QYLR6FSA9n6",
          "xrp": 281.005761
        },
        {
          "account": "r3tJ5QKoNUA8rdGeYY4xo2eyAMKqnrM9JU",
          "xrp": 177.37163488954113
        }
      ]
    },
    {
      "md5": "1b06023c95a7e9c6d77a5c8f74c7c1c7",
      "name": "EVR",
      "currency": "EVR",
      "slug": "ra9g3LAJm9xJu8Awe7oWzR6VXFB1mpFtSe-EVR",
      "xrp": 3028.77057616905,
      "traders": 6,
      "topTraders": [
        {
          "account": "rJgJtPkEWTj4LyGoPXaRctMKooUdrKaotJ",
          "xrp": 2841.040216
        },
        {
          "account": "r9M6PKQCvQiz6DVrCKanmFRmVkeCKZ9qhj",
          "xrp": 186.6
        },
        {
          "account": "rpu4W49o45LHLkfiBvEMXgVHREhHrXrmg5",
          "xrp": 0.5191578844248379
        },
        {
          "account": "r9DW7jqMXqa32TaTujSxdxcpwnPgJayG8V",
          "xrp": 0.28301862262119865
        },
        {
          "account": "rQUFQfuTMhnd1xnh7GrHcvD7WXC1u3U7oX",
          "xrp": 0.2823444076711599
        }
      ]
    },
    {
      "md5": "ce7b81b078cf2c4f6391c39de3425e54",
      "name": "BTC",
      "currency": "BTC",
      "slug": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B-BTC",
      "xrp": 811.4751525332892,
      "traders": 4,
      "topTraders": [
        {
          "account": "rMsXVzCug7nUsMYFGPXBTWY732fRZqxgfY",
          "xrp": 776.828025
        },
        {
          "account": "rP4gybHF3astaSuih16DMpL16aFa6DjYkX",
          "xrp": 23.597867675485986
        },
        {
          "account": "rfyj5KeZrL6SxxMTtoC61HU9EYWomyEuZe",
          "xrp": 10.01875
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 1.0305098578033192
        }
      ]
    },
    {
      "md5": "ef02bf7d8b650fc962227d2a52261383",
      "name": "PHNIX",
      "currency": "50484E4958000000000000000000000000000000",
      "slug": "rDFXbW2ZZCG5WgPtqwNiA2xZokLMm9ivmN-50484E4958000000000000000000000000000000",
      "xrp": 605.1595305704183,
      "traders": 21,
      "topTraders": [
        {
          "account": "rMsrQGK9fZ6B2164QGLnjLMxBYSCY5xJ4W",
          "xrp": 575
        },
        {
          "account": "rEYLNoaQM5bCMUNhrsvMasTMQ1YgZz5hzT",
          "xrp": 15.280746827711928
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 3.1960629103564373
        },
        {
          "account": "rBqUZzPRcVus1phirwuPd7f6QJQQsCdyax",
          "xrp": 1.9180070437132941
        },
        {
          "account": "rJF4MfEjjt8BQ8Xt5kzKBTVofPCKG1yqJ8",
          "xrp": 1.2851440913781147
        }
      ]
    },
    {
      "md5": "455e0411017deea044b6b37a48957414",
      "name": "REAL",
      "currency": "5245414C00000000000000000000000000000000",
      "slug": "rKVyXn1AhqMTvNA9hS6XkFjQNn2VE8Nz88-5245414C00000000000000000000000000000000",
      "xrp": 250.86719555726606,
      "traders": 20,
      "topTraders": [
        {
          "account": "r3tJ5QKoNUA8rdGeYY4xo2eyAMKqnrM9JU",
          "xrp": 177.56262911045883
        },
        {
          "account": "ramzxjVFVfoHDB54cnDcNT1YjwWmmURamA",
          "xrp": 46.9607845773734
        },
        {
          "account": "rGzYNKNQvBeBtFcHQHsCcf6h42X3BrqEkE",
          "xrp": 14.98053531432427
        },
        {
          "account": "rLMwKsJjKpyacdqFrKDjPgvtq9XJ6sA78E",
          "xrp": 1.988935799621426
        },
        {
          "account": "rDdCYqspZfED1jp3m6AUUBhL4WrGytTzjs",
          "xrp": 1.4998580116886953
        }
      ]
    }
  ],
  "rotatedFrom": [
    {
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "name": "USDC",
      "currency": "5553444300000000000000000000000000000000",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "xrp": 33532.09586565956,
      "traders": 43,
      "topTraders": [
        {
          "account": "rLVkkxk7THbb3dCZ6aETvLnzc8HabyubEs",
          "xrp": 26521.087902149382
        },
        {
          "account": "rwG5huGCbXUGsB3NXJQ4A8tdny4rax5iEa",
          "xrp": 1852.358623889562
        },
        {
          "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
          "xrp": 1260.305551
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 1120.8095178178685
        },
        {
          "account": "rJF4MfEjjt8BQ8Xt5kzKBTVofPCKG1yqJ8",
          "xrp": 879.2303824082559
        }
      ]
    },
    {
      "md5": "33d41a287177d13f69da580dde9b968b",
      "name": "XAH",
      "currency": "XAH",
      "slug": "rswh1fvyLqHizBS2awu1vs6QcmwTBd9qiv-XAH",
      "xrp": 2839.6819494987344,
      "traders": 21,
      "topTraders": [
        {
          "account": "rnCEEqDnCuSjDsHiJrca4VYUqaMyi4vGF7",
          "xrp": 2227.676825999997
        },
        {
          "account": "rTeLeproT3BVgjWoYrDYpKbBLXPaVMkge",
          "xrp": 283.039845
        },
        {
          "account": "rwG5huGCbXUGsB3NXJQ4A8tdny4rax5iEa",
          "xrp": 222.70629747591065
        },
        {
          "account": "rMJ1ejWzy5AEF2tzFrv8FQpeR83DMLUQYq",
          "xrp": 53.720350525629016
        },
        {
          "account": "rn5X3RRSdcAz3fLN67ttTbMswS8sR8Nqij",
          "xrp": 13.809612
        }
      ]
    },
    {
      "md5": "27b31c7f69d1d6eed45480cb0b204a6e",
      "name": "LHT",
      "currency": "LHT",
      "slug": "rHashLabsu2H6hXDSunL8AcVDmTyE17Z35-LHT",
      "xrp": 1027.288207379499,
      "traders": 14,
      "topTraders": [
        {
          "account": "rwG5huGCbXUGsB3NXJQ4A8tdny4rax5iEa",
          "xrp": 568.87145685527
        },
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 430.8717591341442
        },
        {
          "account": "rJF4MfEjjt8BQ8Xt5kzKBTVofPCKG1yqJ8",
          "xrp": 10.106249932729053
        },
        {
          "account": "ra3wYLE4HXjQM6uo96TahVhvtMy87xyS4F",
          "xrp": 8.575401014788543
        },
        {
          "account": "rEYLNoaQM5bCMUNhrsvMasTMQ1YgZz5hzT",
          "xrp": 2.046687148214297
        }
      ]
    },
    {
      "md5": "b05f7c8e58b832c74267d988567dea33",
      "name": "FUZZY",
      "currency": "46555A5A59000000000000000000000000000000",
      "slug": "rhCAT4hRdi2Y9puNdkpMzxrdKa5wkppR62-46555A5A59000000000000000000000000000000",
      "xrp": 609.3916689930215,
      "traders": 28,
      "topTraders": [
        {
          "account": "rErSW3gyRyCuzbvAQkQUaCYskSYBdZ1MqM",
          "xrp": 291.8582833915047
        },
        {
          "account": "rapido5rxPmP4YkMZZEeXSHqWefxHEkqv6",
          "xrp": 65.64217219938033
        },
        {
          "account": "rJF4MfEjjt8BQ8Xt5kzKBTVofPCKG1yqJ8",
          "xrp": 58.49915219934862
        },
        {
          "account": "rwG5huGCbXUGsB3NXJQ4A8tdny4rax5iEa",
          "xrp": 56.10339162088303
        },
        {
          "account": "ra3wYLE4HXjQM6uo96TahVhvtMy87xyS4F",
          "xrp": 23.021354029218625
        }
      ]
    },
    {
      "md5": "9b4ddc2e62f736881eef8f9f02812dbc",
      "name": "SHX",
      "currency": "SHX",
      "slug": "rfmS3zqrQrka8wVyhXifEeyTwe8AMz2Yhw-SHX",
      "xrp": 600.6002037070493,
      "traders": 6,
      "topTraders": [
        {
          "account": "rsau42a7p3BbrVvivGcfTPmH2fR74VRdY7",
          "xrp": 400.842237
        },
        {
          "account": "rLFpNiNe4KDBuJQPmJi9dAdho271QmUK8b",
          "xrp": 121.53249799999998
        },
        {
          "account": "rHxcnfnxwQyDCGpKssdzwzB7i7UdxH1bng",
          "xrp": 76.340638
        },
        {
          "account": "rwG5huGCbXUGsB3NXJQ4A8tdny4rax5iEa",
          "xrp": 1.1836956929233293
        },
        {
          "account": "ra3wYLE4HXjQM6uo96TahVhvtMy87xyS4F",
          "xrp": 0.35060555525011944
        }
      ]
    }
  ],
  "rotatedToTokens": 195,
  "rotatedFromTokens": 217,
  "freshCapital": [
    {
      "account": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "xrp": 132254.84325899993
    },
    {
      "account": "r3nVVxJfkdvjiXP1tov5pZdht96JMwGApP",
      "xrp": 114363.30400200002
    },
    {
      "account": "r3cpW3M3nKHfSgkJiEh1BaAy6GJXeZvMLU",
      "xrp": 86429.02012800002
    },
    {
      "account": "rKYdJJLAgxbJcn9Ria2X5jMMiqP91r4qy",
      "xrp": 74614.26263399994
    },
    {
      "account": "rKfa1JLEDBg3MJcs1Tozi3unKfU3PeZq5y",
      "xrp": 66967.410883
    }
  ],
  "freshCapitalTotal": 818896.8281109994,
  "freshCapitalCount": 136
}

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