{"id":"25a36ac5-277d-44e6-a0bd-cdc71507dd32","shortId":"8cPJYy","kind":"x402","title":"Retrieve top token holders with balances, activity, and smart money labels via Nansen's on-chain analytics API.","tagline":"Retrieve top token holders with balances, activity, and smart money labels via Nansen's on-chain analytics API.","description":"The Nansen TGM Holders endpoint (`POST /api/v1/tgm/holders`) returns the top holders of any token across 25+ blockchains, including current balances, 24h/7d/30d balance changes, total inflows/outflows, ownership percentages, and USD valuations. Results can be filtered by holder category (smart money, whales, exchanges, public figures, or all holders) and by smart money label sub-types such as Fund, Smart Trader, or 30D Smart Trader. The endpoint supports premium label tiers, pagination up to 1,000 rows per page, and flexible sort ordering.\n\nThis endpoint is part of Nansen's Token God Mode (TGM) suite and is payable per-call via the x402 protocol at $0.05 per request. It also supports traditional API-key authentication with a credit-based system (50 credits on the free tier, 5 on pro). The response includes rate-limit headers and credit-usage tracking. Native tokens queried with `label_type: \"all_holders\"` use an optimized model with limited filter/sort options to prevent timeouts.\n\nThe API is documented via a full OpenAPI 3.1 spec served at `api.nansen.ai`. Supported chains include Ethereum, Solana, Base, Arbitrum, BNB, Polygon, Bitcoin, Sui, Tron, and many more. Filters include address, token amount ranges, balance change ranges, ownership percentage, value in USD, and smart money label inclusion/exclusion.","tags":[],"capabilities":["token-holders","smart-money-labels","multi-chain","on-chain-analytics","wallet-profiling","balance-tracking","x402-payment","pagination","sort-ordering","label-filtering"],"categories":["blockchain","analytics"],"synonyms":["token holders","whale tracking","smart money holders","on-chain holder analysis","token distribution","Nansen TGM","top holders API","token god mode holders","holder balance changes"],"warnings":["No browsable documentation page found at api.nansen.ai/docs — rely on the OpenAPI spec","Native tokens with label_type 'all_holders' have limited filter/sort options per the API description"],"endpointUrl":"https://api.nansen.ai/api/v1/tgm/holders","protocol":"x402","transport":"http","auth":{"type":"x402","details":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2"},"payTo":"0x93053f1e7A5eFEDa532Fe69CbbE43cBEc3A0F13f","amount":"50000","scheme":"exact","network":"eip155:8453","maxTimeoutSeconds":300},{"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","extra":{"feePayer":"2wKupLR9q6wXYppw8Gr2NvWxKBUqm4PPJKkQfoxHDBg4"},"payTo":"J7ZvJEspvwP1oRxQZ7mYmNmT22NTm3GWq3t7HEbvPZYx","amount":"50000","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","maxTimeoutSeconds":300}]},"qualityScore":"0.920","qualityRationale":"Full OpenAPI 3.1 schema with detailed request/response models, clear x402 payment info ($0.05/call), live 402 challenge confirmed, comprehensive filter and sort documentation. Minor gap: no crawled docs page (returns 404), but the OpenAPI spec is thorough.","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"anthropic/claude-opus-4.6","enrichmentVersion":2,"enrichedAt":"2026-04-22T01:40:30.530Z","embedding":[-0.001159668,0.03717041,0.036376953,-0.016082764,-0.021194458,-0.038360596,-0.05593872,0.033447266,0.009376526,-0.042022705,0.007865906,-0.003862381,0.0068206787,-0.07702637,0.004623413,0.025985718,-0.045013428,0.019439697,-0.007217407,0.055847168,-0.0042800903,0.038208008,0.004901886,0.04083252,-0.009567261,0.010948181,-0.008560181,0.033813477,-0.00036621094,0.0044822693,0.037200928,-0.025268555,-0.0016508102,0.0357666,0.0009975433,0.006614685,0.018188477,0.019088745,-0.009132385,-0.032226562,-0.00605011,0.010612488,0.0047836304,0.030883789,0.004333496,0.034240723,0.012794495,-0.030548096,-0.03765869,0.024810791,-0.034729004,-0.013710022,-0.033325195,0.04168701,0.029418945,0.0015182495,-0.021316528,0.017868042,0.030731201,-0.010894775,-0.032470703,-0.04260254,0.066223145,-0.0068130493,0.016616821,0.010269165,-0.03869629,0.023086548,0.01737976,0.054260254,0.04876709,0.022125244,-0.0028381348,-0.034942627,-0.016983032,-0.028549194,-0.036132812,0.0073051453,-0.024810791,-0.04458618,-0.011077881,-0.02670288,-0.04852295,-0.016296387,0.038513184,-0.0077438354,0.013076782,-0.03451538,-0.07147217,0.007572174,-0.020690918,-0.019836426,0.010551453,0.058624268,0.05722046,-0.061706543,0.030029297,0.0063972473,-0.0007314682,0.0024929047,0.018157959,0.023605347,0.015449524,-0.019927979,0.022537231,0.068847656,-0.017791748,0.008995056,0.032073975,0.015464783,-0.08868408,-0.02029419,-0.017562866,0.0033626556,-0.013076782,0.020019531,-0.044891357,0.045074463,-0.0065841675,-0.010536194,-0.003326416,-0.0010709763,0.06652832,0.0045280457,-0.030303955,0.009063721,-0.03491211,-0.022781372,-0.04168701,0.03967285,-0.03253174,-0.0032844543,0.035369873,-0.02645874,-0.037078857,-0.024917603,-0.044708252,-0.020004272,-0.017608643,0.0146102905,0.008468628,-0.048217773,0.043060303,-0.008384705,-0.07385254,-0.029159546,-0.06188965,0.011703491,-0.08508301,0.017791748,0.011169434,0.01109314,-0.022598267,0.0012626648,0.008506775,-0.027801514,-0.029663086,0.024154663,-0.045928955,-0.0066871643,-0.015007019,0.03829956,-0.025146484,0.03060913,0.008758545,0.055389404,0.014259338,-0.061798096,-0.050598145,0.0020446777,0.013664246,-0.0030879974,-0.035949707,-0.008026123,-0.020111084,-0.013999939,-0.0107040405,0.0038433075,-0.011489868,-0.04208374,-0.012588501,-0.017929077,0.0059013367,-0.035186768,-0.04397583,0.004047394,-0.01890564,0.052703857,0.032989502,0.024810791,-0.009613037,0.018249512,0.053741455,0.06781006,-0.046081543,-0.04168701,0.006263733,0.0070610046,0.033721924,0.024612427,0.02368164,-0.015052795,0.01676941,-0.016296387,-0.046417236,0.014709473,0.012832642,-0.031402588,0.02935791,-0.010055542,0.056549072,-0.006881714,-0.033172607,-0.0066070557,-0.052825928,-0.0027980804,-0.041931152,-0.013999939,-0.005420685,0.055236816,0.0054893494,0.077819824,-0.010948181,-0.01398468,-0.024215698,0.044891357,0.016052246,-0.003648758,-0.0072669983,-0.039367676,0.007221222,0.03918457,0.0035209656,-0.03741455,0.014854431,-0.046936035,0.008522034,-0.029388428,0.031402588,-0.023605347,0.008666992,0.0087509155,0.009933472,0.00920105,0.011665344,-0.011871338,-0.028671265,-0.06262207,0.028121948,0.047546387,0.041381836,0.018829346,-0.0099105835,-0.0071105957,0.007987976,-0.017181396,-0.011695862,0.049621582,-0.015625,-0.042510986,0.033966064,-0.04788208,-0.055480957,0.01499176,-0.006706238,0.00009918213,-0.0027160645,-0.022994995,-0.0206604,-0.011024475,0.0014276505,0.03656006,-0.021484375,-0.06036377,-0.048187256,0.03704834,0.014831543,-0.025405884,-0.024261475,-0.026473999,-0.0070610046,0.006378174,0.0046157837,0.009674072,-0.0231781,-0.044158936,0.02973938,0.032714844,0.0057258606,-0.011665344,0.04284668,-0.00048565865,0.027999878,-0.000310421,0.015853882,0.0006842613,0.049468994,0.002538681,-0.02835083,0.01828003,-0.012931824,0.007972717,-0.0074386597,-0.08215332,0.018539429,-0.029067993,0.036224365,0.018218994,0.0046195984,0.0029964447,-0.01991272,-0.000042259693,-0.008140564,0.00074481964,-0.007221222,-0.016220093,0.036621094,-0.008132935,-0.0051002502,0.0039482117,-0.008766174,-0.028076172,-0.013267517,-0.0023326874,0.0054359436,-0.017868042,0.008430481,-0.04647827,0.002456665,-0.0040359497,0.02720642,-0.0044822693,0.007217407,-0.00762558,-0.008651733,0.019760132,0.005504608,0.027328491,0.0025501251,0.03250122,0.012741089,-0.037506104,0.014099121,-0.031463623,-0.01940918,0.0115356445,-0.008712769,0.04196167,0.0073547363,0.00920105,-0.026473999,0.0042533875,0.042907715,0.033843994,0.023727417,-0.019592285,-0.006904602,-0.05441284,-0.045318604,-0.0023040771,-0.08068848,-0.01663208,0.054992676,0.01626587,0.05404663,0.01763916,-0.035186768,-0.00047636032,0.046936035,-0.1048584,0.024276733,0.013313293,0.022140503,-0.0078048706,-0.029006958,0.021713257,0.03286743,0.0049934387,0.006706238,-0.029418945,0.07141113,-0.046936035,0.028198242,-0.019927979,0.015312195,0.046020508,-0.009460449,-0.012245178,-0.041931152,-0.010292053,0.03060913,-0.020996094,-0.044006348,-0.023040771,-0.027374268,-0.01927185,0.00712204,0.01197052,-0.0075569153,0.03439331,-0.004951477,0.022201538,-0.04119873,-0.05935669,-0.015205383,0.0013484955,0.0047569275,0.050689697,0.013824463,-0.03277588,0.011558533,0.009590149,0.0103302,-0.038360596,0.035064697,0.011543274,-0.021530151,0.0084991455,-0.006515503,-0.0028915405,0.015274048,-0.021362305,0.02494812,-0.018203735,-0.0635376,-0.014099121,0.050964355,-0.03451538,-0.026855469,-0.06781006,0.012893677,-0.0037975311,0.0051574707,-0.051757812,-0.023742676,-0.005092621,0.022338867,0.023452759,-0.00333786,0.034698486,-0.011116028,-0.04058838,-0.049468994,-0.038848877,0.0015487671,0.022094727,0.0008826256,-0.06744385,0.0046844482,-0.03314209,0.018157959,0.020645142,0.036254883,-0.00982666,-0.009429932,-0.007091522,0.038726807,0.032226562,0.0435791,-0.019546509,0.0131073,-0.040985107,-0.001461029,-0.004180908,0.0007648468,-0.03930664,-0.03933716,-0.007843018,0.07409668,0.01638794,0.041870117,-0.007507324,-0.06161499,-0.0149383545,-0.008575439,0.0021877289,0.00058841705,-0.012359619,-0.0021419525,-0.012680054,-0.02217102,-0.017120361,-0.08135986,-0.015472412,0.08111572,0.061309814,0.009735107,0.012710571,0.0024585724,-0.033599854,0.01524353,-0.017929077,0.023483276,-0.012870789,-0.018356323,-0.027893066,-0.0019454956,-0.038330078,-0.0024757385,-0.003929138,0.0013837814,-0.02911377,-0.0035152435,0.031311035,-0.007369995,-0.033935547,0.012306213,0.010467529,-0.011238098,0.078063965,-0.05419922,0.021621704,-0.030883789,-0.0054626465,-0.004737854,-0.016921997,0.0058403015,0.049468994,-0.01008606,0.013191223,0.0009703636,0.02418518,-0.011390686,-0.03717041,0.0014457703,-0.0010147095,-0.00605011,-0.030929565,0.0065460205,0.014320374,0.011375427,-0.044403076,0.009216309,0.03503418,-0.013572693,-0.006061554,0.018829346,-0.0149383545,-0.033050537,-0.029678345,-0.0055351257,-0.016662598,-0.02406311,-0.007270813,0.044403076,-0.01020813,0.024734497,0.014183044,0.01928711,0.031555176,0.0069999695,-0.015426636,0.0395813,-0.011726379,-0.01626587,0.013549805,0.027023315,-0.019363403,0.04107666,0.018661499,0.023117065,-0.023330688,0.05783081,-0.020706177,0.0021419525,0.0073890686,-0.0030117035,0.044525146,0.005886078,0.014022827,0.01285553,-0.0073661804,0.021591187,-0.020935059,0.039611816,-0.005264282,-0.017150879,0.0015659332,0.044067383,0.014907837,-0.053894043,-0.026107788,-0.0053634644,0.029037476,-0.034057617,0.033050537,-0.032928467,0.026260376,-0.035858154,-0.022827148,0.04547119,0.0017004013,0.004459381,0.014045715,0.0050468445,-0.035461426,-0.006187439,-0.011131287,0.015731812,0.015068054,0.011520386,-0.021530151,-0.033935547,-0.004623413,-0.007621765,0.0211792,0.0016641617,0.010101318,0.006500244,0.026550293,-0.019683838,0.007080078,-0.019134521,-0.005054474,-0.006954193,0.013031006,-0.029907227,0.0033912659,-0.005996704,0.020980835,0.018600464,-0.0017948151,0.042907715,0.00072717667,0.00052022934,0.016998291,0.0037631989,-0.015975952,-0.05215454,0.033569336,0.002779007,-0.0042877197,0.02784729,-0.008026123,-0.011871338,0.042510986,-0.019638062,0.017211914,0.016952515,-0.054901123,0.02420044,-0.016525269,-0.0019340515,0.011184692,-0.019729614,-0.015304565,-0.015472412,-0.016082764,-0.039642334,-0.013404846,-0.023010254,-0.030258179,0.0317688,-0.040771484,-0.0030117035,0.005138397,-0.015205383,-0.029632568,0.006034851,0.029342651,-0.056396484,0.032409668,-0.021408081,0.03564453,-0.010070801,0.0006108284,-0.021270752,0.011070251,-0.011329651,0.017944336,-0.020446777,0.06488037,0.0022335052,-0.016036987,0.061950684,0.016464233,0.012039185,-0.039489746,0.020858765,0.03842163,0.0007791519,0.02293396,-0.025436401,-0.011726379,0.032989502,-0.010696411,0.0340271,0.01197052,0.06225586,0.0039711,-0.017089844,-0.010498047,0.0047416687,-0.02607727,0.02267456,0.0053215027,-0.0031261444,0.027679443,-0.02583313,-0.006275177,-0.020004272,0.0037441254,-0.050933838,-0.0501709,-0.010650635,0.008415222,0.006652832,0.031311035,0.014434814,-0.035980225,-0.019256592,0.028686523,-0.036743164,0.0015439987,-0.023269653,0.005367279,-0.0019817352,0.011100769,0.00032258034,-0.033569336,-0.0047416687,0.028076172,-0.01586914,0.0024375916,0.008033752,0.0031223297,0.00920105,0.02166748,0.012664795,-0.02848816,-0.031021118,0.0029277802,-0.03744507,-0.009277344,-0.04272461,0.027542114,0.012779236,-0.03265381,-0.006477356,0.00030946732,0.00869751,-0.032714844,-0.00806427,-0.034606934,0.022994995,-0.0011425018,0.03186035,-0.018707275,0.006336212,-0.02281189,-0.033996582,0.008934021,0.011199951,0.0109939575,0.0368042,-0.03353882,-0.026275635,-0.032104492,-0.010803223,0.008361816,0.0030670166,0.024047852,0.0035743713,0.042236328,-0.017623901,-0.015304565,-0.0435791,0.04638672,-0.017974854,-0.011833191,0.0074386597,-0.010253906,0.019042969,0.009361267,0.042785645,-0.05883789,0.01776123,0.010902405,0.01083374,-0.02078247,-0.0050697327,-0.036254883,0.008811951,-0.017227173,-0.0072898865,0.04321289,-0.004901886,0.008323669,0.020370483,-0.009941101,-0.06121826,0.009239197,-0.018661499,-0.020004272,-0.031463623,0.036224365,-0.0016784668,-0.06976318,-0.014839172,0.03427124,-0.020431519,-0.023712158,0.0041618347,-0.015609741,0.031677246,-0.0062294006,-0.009811401,0.011795044,-0.041259766,-0.009979248,-0.00019347668,0.023132324,0.014778137,0.017562866,0.019073486,0.017059326,-0.0014572144,-0.0072898865,-0.0028762817,-0.01675415,-0.0039405823,-0.027145386,0.018096924,0.00089645386,-0.012138367,0.04046631,-0.030075073,0.0075187683,0.012107849,0.024627686,0.016723633,0.0030784607,-0.007537842,0.01701355,-0.052459717,-0.015403748,0.023010254,0.0043525696,-0.0044136047,0.005214691,0.0062561035,-0.013267517,-0.026977539,-0.02305603,-0.008651733,-0.0104904175,0.00969696,0.020599365,-0.006134033,0.015174866,0.014678955,-0.020095825,-0.029312134,0.030731201,0.030929565,-0.03375244,0.011871338,-0.021759033,0.013404846,0.006324768,-0.00074768066,-0.02583313,0.019424438,0.01928711,-0.0015668869,-0.0048217773,0.0034313202,0.0048599243,0.0039100647,0.0034618378,0.030532837,0.003396988,0.00484848,0.017654419,0.01398468,-0.00035119057,0.0026245117,-0.011299133,-0.008308411,-0.0030612946,0.0090789795,0.0051994324,0.0071868896,0.0043296814,0.002117157,-0.0030136108,-0.042297363,-0.0070381165,0.004940033,0.014381409,0.024276733,0.0076141357,-0.023605347,-0.01826477,0.017501831,0.006576538,-0.032043457,0.04336548,-0.0184021,-0.011291504,0.034240723,-0.017593384,-0.012336731,0.0181427,-0.01687622,-0.0390625,-0.010215759,0.024765015,0.030929565,0.0099105835,0.021896362,0.052612305,0.0044441223,-0.0073280334,0.02041626,0.019515991,0.0064964294,0.054016113,0.014457703,-0.022003174,0.021408081,0.005207062,0.01979065,0.0022964478,0.026535034,-0.0042686462,-0.01626587,-0.03677368,0.03265381,0.01586914,-0.025421143,0.0017719269,0.0033931732,0.014381409,0.018737793,0.0061836243,-0.023635864,0.0006146431,-0.019515991,-0.002500534,0.02281189,0.035095215,0.011001587,-0.027694702,-0.0234375,0.0072669983,0.0003182888,0.001906395,0.029434204,-0.0065841675,0.0056114197,-0.008926392,-0.008560181,-0.03878784,0.026947021,-0.023010254,0.06512451,0.03262329,0.04916382,0.010887146,0.037872314,-0.0044822693,-0.02079773,-0.045196533,0.0107040405,0.015464783,0.015548706,-0.021636963,-0.01423645,0.03353882,-0.00044560432,0.021240234,-0.028549194,0.0368042,0.017929077,0.006969452,0.0038414001,-0.014755249,-0.010437012,0.027526855,0.022705078,0.015052795,-0.044036865,-0.04067993,-0.0129776,-0.02168274,0.022140503,-0.009864807,0.07739258,-0.0026454926,0.028549194,0.011100769,-0.034423828,0.013786316,0.008872986,-0.011993408,0.0042304993,0.04586792,0.01789856,0.006603241,-0.009521484,0.017196655,0.017166138,0.007701874,-0.023803711,-0.0022029877,0.06137085,-0.000644207,0.010421753,-0.035095215,0.0045204163,-0.016418457,-0.031677246,0.0049705505,-0.023925781,-0.0041007996,0.012336731,-0.04626465,-0.005142212,-0.00071430206,-0.014915466,-0.00079107285,0.009735107,-0.005256653,0.012535095,0.009384155,0.00012373924,-0.019134521,0.0135650635,0.000705719,-0.0018510818,0.012870789,0.0107803345,0.0035591125,0.020721436,0.005458832,0.0026397705,0.0051002502,0.012268066,0.002532959,-0.0011940002,-0.016204834,0.009124756,0.024536133,0.055358887,0.0047950745,0.038848877,0.026184082,0.013031006,0.0067825317,-0.003238678,0.009597778,-0.016525269,0.019348145,0.019134521,0.002067566,-0.0043029785,-0.008796692,0.036834717,0.007347107,-0.008277893,0.008491516,0.016647339,-0.030349731,-0.008979797,0.03062439,0.0058288574,0.019134521,0.0077705383,-0.023025513,0.012435913,-0.0038280487,0.033081055,0.012634277,0.008522034,0.020812988,0.019439697,0.0016117096,-0.010810852,-0.019927979,-0.024002075,-0.0048179626,-0.022628784,-0.023590088,0.0023155212,0.03933716,-0.003490448,0.02494812,0.033081055,0.026550293,-0.008293152,0.0021266937,0.042053223,0.010246277,-0.01889038,-0.00655365,-0.009498596,0.040222168,0.02519226,-0.010726929,-0.01576233,0.011627197,0.0048942566,0.03555298,-0.025985718,0.0010795593,-0.0017576218,-0.00082445145,0.013671875,0.003282547,0.022735596,0.00016975403,0.034606934,0.021621704,-0.033294678,0.008354187,0.03564453,0.012619019,-0.04058838,-0.0012340546,0.011787415,-0.028915405,0.020095825,0.04067993,-0.018615723,-0.019866943,0.035003662,0.016464233,0.0053596497,-0.024276733,0.02986145,-0.040527344,0.006626129,0.0022602081,-0.012878418,-0.010269165,-0.04156494,-0.013214111,-0.010246277,-0.0034217834,0.015686035,-0.004802704,0.029266357,-0.0011510849,0.013389587,0.016067505,-0.021408081,0.059020996,0.0014629364,-0.006893158,-0.0074043274,-0.010231018,0.021728516,0.016433716,0.020446777,0.014205933,0.03439331,-0.0036258698,-0.0234375,-0.017822266,-0.015899658,0.015007019,-0.015472412,-0.0149383545,0.0028686523,-0.00022256374,0.017562866,0.011833191,0.0065841675,0.0082092285,0.011268616,0.012199402,-0.019332886,-0.0047721863,0.033721924,-0.023284912,-0.015403748,-0.016326904,0.0087509155,-0.025115967,0.036834717,-0.015586853,-0.040527344,-0.02494812,0.02357483,0.0022029877,0.021118164,0.009269714,-0.053100586,0.037200928,-0.007369995,-0.0079574585,-0.032287598,0.03866577,-0.014198303,0.020263672,-0.0357666,-0.040802002,0.0050201416,0.0032081604,-0.0034008026,0.035614014,0.018722534,0.029266357,0.034301758,0.047729492,-0.026107788,0.032928467,-0.0076828003,-0.01285553,-0.0027675629,-0.018478394,-0.037902832,0.024398804,-0.031585693,-0.010978699,-0.0026073456,0.00356102,0.017990112,-0.0002361536,-0.0036201477,0.022872925,0.0045547485,0.014839172,0.016525269,-0.009750366,0.018066406,-0.010177612,0.022583008,0.014579773,0.02268982,-0.050354004,0.04724121,-0.0040245056,0.014694214,-0.033355713,-0.0047035217,-0.013465881,0.012771606,-0.0015678406,0.035064697,-0.008224487,0.00730896,-0.0135269165,-0.026153564,0.03677368,0.0028495789,0.0052986145,0.024551392,-0.011169434,0.019042969,0.008491516,0.0084991455,-0.002922058,0.00045108795,-0.025054932,-0.0035266876,-0.0036830902,-0.008796692,-0.0074272156,-0.020874023,-0.0024375916,0.027694702,0.015853882,0.0040512085,-0.047576904,0.008262634,0.027740479,0.010650635,-0.0064849854,0.010658264,-0.015625,-0.00920105,0.002632141,0.021087646,0.014221191,-0.009063721,0.020019531,0.020828247,0.04574585,-0.012268066,0.018295288,0.020858765,0.0033683777,-0.020385742,0.023864746,0.026870728,-0.02848816,0.013572693,-0.005504608,-0.012840271,0.018661499,0.022247314,0.004878998,-0.013137817,-0.009918213,-0.027175903,0.0072364807,-0.014343262,0.00894165,-0.0012273788,-0.0065078735,-0.024810791,-0.003955841,-0.012641907,0.0005412102,0.028121948,-0.007320404,-0.02772522,-0.064208984,-0.01927185,-0.0072288513,-0.03591919,-0.019683838,0.030975342,0.015548706,0.053619385,0.019165039,-0.005420685,-0.010070801,0.014579773,0.02947998,0.012901306,-0.010177612,-0.010612488,-0.008590698,-0.010047913,0.0062026978,-0.009849548,0.017303467,-0.04800415,0.022628784,-0.0021877289,0.011230469,-0.01574707,0.007858276,0.028686523,0.015960693,-0.038513184,-0.021469116,0.000831604,0.033172607,0.01725769,0.022415161,-0.015563965,-0.019119263,-0.012214661,0.023483276,0.028839111,0.019226074,-0.0046310425,-0.029876709,0.018432617,-0.0022239685,-0.02848816,-0.01550293,0.012565613,-0.0019311905,0.021728516,0.029190063,0.012069702,0.021377563,-0.046020508,-0.017166138,0.034118652,0.033813477,-0.02796936,-0.018341064,0.022399902,0.0037879944,-0.030685425,-0.02911377,0.026412964,-0.017242432,0.0039787292,-0.0036392212,-0.014556885,0.0029354095,-0.036468506,0.020004272,0.049743652,-0.014839172,-0.025939941,0.00027275085,-0.027923584,0.021224976,-0.02279663,-0.023208618,-0.027374268,0.027420044,0.013000488,-0.0088272095,0.008415222,0.01751709,-0.02255249,-0.0184021,0.012756348,0.020477295,0.005332947,-0.005580902,-0.013664246,-0.036132812,0.008056641,0.0119018555,0.038391113,0.050323486,-0.0035057068,-0.03894043,-0.023803711,-0.0088272095,-0.014274597,0.0011758804,0.051513672,0.0004079342,-0.011169434,-0.020004272,0.020019531,-0.00667572,-0.006401062,-0.0025348663,-0.029937744,0.02720642,0.03314209,-0.017044067,0.0058403015,0.039916992,0.012992859,-0.0020160675,-0.015403748,0.013175964,0.013465881,-0.013031006,-0.0073661804,-0.007129669,0.006008148,0.036132812,0.01789856,0.014831543,-0.012565613,-0.023544312,-0.026138306,-0.02748108,0.006904602,0.043701172,-0.04434204,0.02420044,0.016998291,-0.0051460266,0.0004925728,-0.012939453,-0.03778076,0.015289307,-0.025741577,0.0045661926,0.06011963,0.037719727,0.011161804,-0.008857727,0.0039749146,-0.013404846,-0.016220093,0.024612427,0.01727295,-0.00944519,0.037597656,0.015731812,-0.0181427,0.029266357,-0.003162384,0.017974854,-0.005268097,-0.0002875328,0.0045700073,-0.0054855347,0.01675415,-0.005115509,-0.037200928,0.0049972534,0.004966736,0.0026111603,0.017852783,0.013534546,-0.009010315,0.024734497,0.027175903,0.042663574,-0.060577393,-0.0027694702,0.020401001,-0.0029067993,0.012306213,0.029464722,0.016189575,0.014373779,-0.037872314,-0.025665283,0.005710602,0.011680603,0.045043945,-0.0015974045,-0.0115356445,-0.017868042,0.026000977,0.021881104,0.013763428,-0.01361084,-0.053222656,0.0063285828,-0.016845703,0.029678345,0.024749756,-0.050476074,0.019058228,0.02230835,-0.002128601,-0.026153564,0.029388428,0.011581421,-0.012489319,-0.019470215,0.000012874603,-0.015563965,0.019592285,0.021865845,-0.004802704,0.020736694,0.014183044,0.036956787,0.047790527,0.006011963,-0.009567261,0.030059814,-0.024429321,-0.014472961,0.02923584,-0.031311035],"createdAt":"2026-04-21T18:32:35.526Z","updatedAt":"2026-04-22T16:33:11.861Z","lastSeenAt":"2026-04-22T16:33:11.861Z","tsv":"'/api/v1/tgm/holders':45 '0.05':143 '000':112 '1':111 '24h/7d/30d':59 '25':54 '3.1':208 '30d':99 '5':166 '50':160 'Nansen TGM' 'across':53 'activ':7,26 'address':230 'also':147 'amount':232 'analyt':18,37 'api':19,38,151,201 'api-key':150 'api.nansen.ai':212 'arbitrum':219 'authent':153 'balanc':6,25,58,60,234 'balance-tracking' 'base':158,218 'bitcoin':222 'blockchain':55 'bnb':220 'call':137 'categori':75 'chain':17,36,214 'chang':61,235 'credit':157,161,178 'credit-bas':156 'credit-usag':177 'current':57 'document':203 'endpoint':43,103,121 'ethereum':216 'exchang':79 'figur':81 'filter':72,228 'filter/sort':195 'flexibl':117 'free':164 'full':206 'fund':95 'god':128 'header':175 'holder':4,23,42,49,74,84,188 'holder balance changes' 'includ':56,171,215,229 'inclusion/exclusion':246 'inflows/outflows':63 'key':152 'label':11,30,89,106,185,245 'label-filtering' 'limit':174,194 'mani':226 'mode':129 'model':192 'money':10,29,77,88,244 'multi-chain' 'nansen':13,32,40,125 'nativ':181 'on-chain':15,34 'on-chain holder analysis' 'on-chain-analytics' 'openapi':207 'optim':191 'option':196 'order':119 'ownership':64,237 'page':115 'pagin':108 'pagination' 'part':123 'payabl':134 'per':114,136,144 'per-cal':135 'percentag':65,238 'polygon':221 'post':44 'premium':105 'prevent':198 'pro':168 'protocol':141 'public':80 'queri':183 'rang':233,236 'rate':173 'rate-limit':172 'request':145 'respons':170 'result':69 'retriev':1,20 'return':46 'row':113 'serv':210 'smart':9,28,76,87,96,100,243 'smart money holders' 'smart-money-labels' 'solana':217 'sort':118 'sort-ordering' 'spec':209 'sub':91 'sub-typ':90 'sui':223 'suit':131 'support':104,148,213 'system':159 'tgm':41,130 'tier':107,165 'timeout':199 'token':3,22,52,127,182,231 'token distribution' 'token god mode holders' 'token holders' 'token-holders' 'top':2,21,48 'top holders API' 'total':62 'track':180 'trader':97,101 'tradit':149 'tron':224 'type':92,186 'usag':179 'usd':67,241 'use':189 'valu':239 'valuat':68 'via':12,31,138,204 'wallet-profiling' 'whale':78 'whale tracking' 'x402':140 'x402-payment'","prices":[{"id":"fcece5c0-6c1d-4adf-9d86-4c3265ea330d","listingId":"25a36ac5-277d-44e6-a0bd-cdc71507dd32","amountUsd":null,"unit":"per_call","nativeCurrency":"USD COIN","nativeAmount":null,"chain":"base","payTo":"0x93053f1e7A5eFEDa532Fe69CbbE43cBEc3A0F13f","paymentMethod":"x402-usd coin","isPrimary":true,"details":{"scheme":"exact","accepts_all":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2"},"payTo":"0x93053f1e7A5eFEDa532Fe69CbbE43cBEc3A0F13f","amount":"50000","scheme":"exact","network":"eip155:8453","maxTimeoutSeconds":300},{"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","extra":{"feePayer":"2wKupLR9q6wXYppw8Gr2NvWxKBUqm4PPJKkQfoxHDBg4"},"payTo":"J7ZvJEspvwP1oRxQZ7mYmNmT22NTm3GWq3t7HEbvPZYx","amount":"50000","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","maxTimeoutSeconds":300}],"asset_contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","max_timeout_seconds":300},"createdAt":"2026-04-21T18:32:35.526Z"}],"sources":[{"listingId":"25a36ac5-277d-44e6-a0bd-cdc71507dd32","source":"x402_bazaar","sourceId":"https://api.nansen.ai/api/v1/tgm/holders","sourceUrl":"https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources","isPrimary":true,"firstSeenAt":"2026-04-21T18:32:35.526Z","lastSeenAt":"2026-04-22T16:33:11.861Z"}],"details":{"listingId":"25a36ac5-277d-44e6-a0bd-cdc71507dd32","quickStartSnippet":"curl -X POST https://api.nansen.ai/api/v1/tgm/holders \\\n  -H 'Content-Type: application/json' \\\n  -H 'X-Payment: <x402-payment-header>' \\\n  -d '{\n    \"chain\": \"ethereum\",\n    \"token_address\": \"0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9\",\n    \"label_type\": \"smart_money\",\n    \"pagination\": {\"page\": 1, \"per_page\": 10}\n  }'","exampleRequest":{"chain":"ethereum","filters":{"value_usd":{"min":10000},"include_smart_money_labels":["Fund","Smart Trader"]},"order_by":[{"field":"value_usd","direction":"DESC"}],"label_type":"smart_money","pagination":{"page":1,"per_page":10},"token_address":"0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"},"exampleResponse":{"data":[{"address":"0x1234567890123456789012345678901234567890","value_usd":150000,"token_amount":50000,"total_inflow":52000,"address_label":"Smart Trader Fund A","total_outflow":2000,"balance_change_7d":5000,"balance_change_24h":1500,"balance_change_30d":15000,"ownership_percentage":0.33}],"pagination":{"page":1,"per_page":10,"is_last_page":false}},"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[{"claim":"Endpoint price is $0.05 per call via x402","source_url":"https://api.nansen.ai"},{"claim":"Credit cost is 50 (free tier) or 5 (pro tier), with premium_labels=true costing 150 pro credits","source_url":"https://api.nansen.ai"},{"claim":"Endpoint returns 402 Payment Required confirming x402 liveness","source_url":"https://api.nansen.ai/api/v1/tgm/holders"},{"claim":"Supports 25+ chains including ethereum, solana, base, bitcoin, sui, tron, etc.","source_url":"https://api.nansen.ai"},{"claim":"Native tokens with all_holders label use an optimized model with limited ordering and filters","source_url":"https://api.nansen.ai"}],"useCases":["Identify which smart money wallets are accumulating or distributing a specific token","Analyze token holder concentration and ownership distribution across chains","Monitor 24h/7d/30d balance changes of top holders for trading signals","Filter holders by label type (whale, exchange, smart money) for due diligence","Build dashboards showing real-time holder composition for any ERC-20 or SPL token"],"bestFor":["Crypto traders tracking smart money accumulation patterns","Research analysts studying token holder distribution","DeFi protocols monitoring their token's holder base","Agents needing per-call blockchain analytics without subscriptions"],"notFor":["Historical holder snapshots over time (use /smart-money/historical-holdings instead)","Non-blockchain or non-crypto data needs","Free high-volume usage — each call costs $0.05 via x402"],"kindDetails":{},"updatedAt":"2026-04-22T01:40:30.530Z"}}