GET /holders/movers/{id}
GET

/v1/holders/movers/{id}

Top 24h buyers and sellers by holder balance delta

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/holders/movers/0dd550278b74cb6690fdae351e8e0df3
Path parameterValueDescription
idA token id: its md5, slug or issuer_currency
Query parameterValueDescription
limitint per side (default: 20, max 50)
curl 'https://api.xrpl.to/v1/holders/movers/0dd550278b74cb6690fdae351e8e0df3'

Response

200Example response1906 ms · just now · 7.8 KB · 411 lines
https://api.xrpl.to/v1/holders/movers/0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "took": 1904,
  "limit": 20,
  "pressure": {
    "m15": {
      "sellers": 22,
      "sellPressureXrp": 54174.7698183904,
      "buyers": 53,
      "buyPressureXrp": 955869.6889300004
    },
    "m30": {
      "sellers": 25,
      "sellPressureXrp": 62461.155317649354,
      "buyers": 59,
      "buyPressureXrp": 972393.0977240003
    },
    "h1": {
      "sellers": 30,
      "sellPressureXrp": 174297.96440382508,
      "buyers": 64,
      "buyPressureXrp": 1000751.6268650002
    },
    "h4": {
      "sellers": 62,
      "sellPressureXrp": 266604.9422997705,
      "buyers": 132,
      "buyPressureXrp": 1172889.6214040006
    },
    "h24": {
      "sellers": 186,
      "sellPressureXrp": 485835.4933582228,
      "buyers": 234,
      "buyPressureXrp": 1498182.4016830008
    }
  },
  "holders": 68205,
  "movers": 923,
  "buyersTotal": 504,
  "sellersTotal": 419,
  "boughtTotal": 68080311.50795518,
  "soldTotal": 46029152.69628709,
  "boughtTotalXrp": 72929746.90749794,
  "soldTotalXrp": 49307859.822505966,
  "buyers": [
    {
      "account": "rPz2qA93PeRCyHyFCqyNggnyycJR1N4iNf",
      "balance": 71740275.576,
      "balance24h": 31608112.884,
      "change": 40132162.692,
      "holding": 9.33,
      "value": 76850414.23790309,
      "trades": [
        [
          1795229680000,
          1,
          32059552.48,
          852836999.23,
          2
        ],
        [
          1795239280000,
          1,
          3945439.87,
          878845030.64,
          2
        ],
        [
          1795258461000,
          1,
          6394621.64,
          857046257.49,
          2
        ],
        [
          1795267832000,
          1,
          2244594.06,
          839003160.12,
          2
        ]
      ],
      "name": "Binance"
    },
    {
      "account": "raRwevcTC4NafoNUP28JfmfrKYtdeQWwZ2",
      "balance": 21300000,
      "balance24h": 6300000,
      "change": 15000000,
      "holding": 2.77,
      "value": 22817222.40574929,
      "trades": [
        [
          1795207930000,
          1,
          16941866.91,
          868052793.93,
          2
        ]
      ],
      "name": null
    },
    {
      "account": "rBNCyNEwpaEbGP9nqkQeYcvwYAwwKkRzTR",
      "balance": 36687874.42500948,
      "balance24h": 28964097.42500948,
      "change": 7723777,
      "holding": 4.77,
      "value": 39301192.035194494,
      "trades": [
        [
          1795213700000,
          1,
          6741205.65,
          842439249.92,
          2
        ],
        [
          1795252850000,
          1,
          4197159.33,
          861842004.65,
          2
        ],
        [
          1795257132000,
          1,
          3068434.46,
          862216088.54,
          2
        ],
        [
          1795257872000,
          -1,
          5488726.96,
          860159102.15,
          2
        ]
      ],
      "name": null
    },
    {
      "account": "r39TAwuqkA5BNxxfL5YXewRGtCgBcADjcx",
      "balance": 56550138.6340507,
      "balance24h": 54015334.6840507,
      "change": 2534803.95,
      "holding": 7.35,
      "value": 60578267.14972255,
      "trades": [
        [
          1795196440000,
          -1,
          11092972.41,
          852558258.14,
          2
        ],
        [
          1795196582000,
          1,
          11092972.41,
          852558258.14,
          2
        ],
        [
          1795197690000,
          -1,
          11034113.52,
          848034616.01,
          2
        ],
        [
          1795197912000,
          1,
          11010324.19,
          846206270.53,
          2
        ],
        [
          1795199000000,
          -1,
          10955542.43,
          841995979.48,
          2
        ]
      ],
      "name": null
    },
    {
      "account": "rHCE7bhuPEiYcKxkWoHdxe3rTeuMsDxEDm",
      "balance": 1000306.0000102,
      "balance24h": 0.0000102,
      "change": 1000306,
      "holding": 0.13,
      "value": 1071558.895588647,
      "trades": [
        [
          1795196941000,
          1,
          111.66,
          849661763.68,
          2
        ],
        [
          1795204071000,
          1,
          113.83,
          857675577.62,
          2
        ],
        [
          1795204091000,
          1,
          114.94,
          857675577.62,
          2
        ],
        [
          1795207190000,
          1,
          1124918.98,
          864564459.53,
          2
        ]
      ],
      "name": null
    }
  ],
  "sellers": [
    {
      "account": "r9nsQj5fGr1TcDpCGqntaVWYqt53qS7mSN",
      "balance": 4485451.683166978,
      "balance24h": 35152200.22009376,
      "change": -30666748.536926784,
      "holding": 0.58,
      "value": 4804955.335448988,
      "trades": [
        [
          1795196230000,
          1,
          17833.58,
          852110944.35,
          2
        ],
        [
          1795198031000,
          1,
          2715.15,
          846206270.53,
          2
        ],
        [
          1795198571000,
          1,
          18798.73,
          846708257.66,
          2
        ],
        [
          1795201631000,
          1,
          18101.22,
          853098368.18,
          2
        ],
        [
          1795202701000,
          1,
          7310.74,
          857689212.97,
          2
        ]
      ],
      "name": null
    },
    {
      "account": "ra8xqX4QhcogFfxpMxMByvFnXyxw9E8rzY",
      "balance": 7321913.99800072,
      "balance24h": 13800000.00000072,
      "change": -6478086.002,
      "holding": 0.95,
      "value": 7843461.977847483,
      "trades": [
        [
          1795251851000,
          -1,
          4212469.55,
          864974240.63,
          2
        ],
        [
          1795256871000,
          -1,
          3057083.94,
          859010940.48,
          2
        ]
      ],
      "name": null
    },
    {
      "account": "rDgBDkeTe5rbtRn2DJP8kHvQTuw28h8UVr",
      "balance": 7851092.99588623,
      "balance24h": 10899699.53951716,
      "change": -3048606.54363093,
      "holding": 1.02,
      "value": 8410334.97724679,
      "trades": [
        [
          1795197321000,
          -1,
          2721.96,
          848331140.14,
          2
        ],
        [
          1795204261000,
          1,
          84399.33,
          862094322.44,
          2
        ],
        [
          1795207801000,
          1,
          4524.94,
          868052793.93,
          2
        ],
        [
          1795209680000,
          -1,
          167860.83,
          860070889.83,
          2
        ],
        [
          1795217330000,
          1,
          982742.48,
          845741131.04,
          2
        ]
      ],
      "name": null
    },
    {
      "account": "rEq4b7nbL2ep44Fgk9bPwpynGRjyESpf5B",
      "balance": 141650041.6700765,
      "balance24h": 144150041.6700765,
      "change": -2500000,
      "holding": 18.43,
      "value": 151739929.7920089,
      "trades": [
        [
          1795197782000,
          -1,
          2758528.38,
          848034616.01,
          2
        ]
      ],
      "name": "Gemini"
    },
    {
      "account": "rpr1MrBS6EPff1Tnnx4obsU7TcuEcwomNC",
      "balance": 76.61,
      "balance24h": 1000087.61,
      "change": -1000011,
      "holding": 0,
      "value": 82.06701448377714,
      "trades": [
        [
          1795196941000,
          -1,
          111.66,
          849661763.68,
          2
        ],
        [
          1795201452000,
          -1,
          114.07,
          851124729.16,
          2
        ],
        [
          1795201822000,
          -1,
          113.68,
          856560069.83,
          2
        ],
        [
          1795204071000,
          -1,
          113.83,
          857675577.62,
          2
        ],
        [
          1795204091000,
          -1,
          114.94,
          857675577.62,
          2
        ]
      ],
      "name": null
    }
  ]
}

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

Shapeas documented
{
  success,
  took,
  limit,
  holders (total),
  movers (holders with a 24h change),
  buyersTotal,
  sellersTotal,
  boughtTotal/soldTotal (token-unit sums over all movers) + boughtTotalXrp/soldTotalXrp,
  pressure?: {
    m15/m30/h1/h4/h24: {
      sellers,
      sellPressureXrp (holdings value of recently-active sellers),
      buyers,
      buyPressureXrp (XRP balances of recently-active buyers)
    }
  },
  buyers[]/sellers[] (capped at limit): {
    account,
    name,
    balance,
    balance24h,
    change (token delta,
    signed),
    holding (% of supply),
    value? (current holdings worth,
    XRP),
    pnl?/roi? (trading gain/loss XRP + %),
    lastTrade? (last trade of this token),
    breakevenMcap? (entry breakeven: mcap XRP where their held tokens equal their FIFO cost),
    trades? (24h balance-change events [
      timeMs,
      side,
      xrpValue,
      mcapAtEvent,
      kind
    ] from trusts_24h + hourly candles; side 1=received/-1=sent,
    kind 0=trade/1=LP/2=transfer,
    max 120),
    isAMM?,
    isCreator?,
    freeze?
  }
}

What it does

Top 24h buyers and sellers by holder balance delta

A token id can be its md5, slug or issuer_currency. How to build an md5 →
OpenAPI