{"id":"be9075ab-4844-45c9-90f7-24eb57cdcba5","shortId":"RXTPFD","kind":"mpp","title":"Rank perpetual traders by realized and unrealized PnL for a specific Hyperliquid perp contract.","tagline":"Rank perpetual traders by realized and unrealized PnL for a specific Hyperliquid perp contract.","description":"This endpoint ranks traders by their profit/loss performance for a specific perpetual contract on Hyperliquid. It returns both realized profits (from completed trades) and unrealized profits (from current holdings), along with ROI percentages, position values, netflow amounts, and trading patterns. The data covers Hyperliquid perpetual contracts exclusively.\n\nThe endpoint accepts a token symbol (e.g., \"BTC\", \"ETH\", \"SOL\"), a date range, optional filters (trader address, PnL ranges, smart money labels, position values, number of trades), and pagination parameters. Results can be sorted by realized PnL, unrealized PnL, total PnL, ROI metrics, holding amounts, position value, and more. Premium labels (smart money classifications) are available as an optional parameter.\n\nPricing is $0.05 per call via the x402 protocol, or 50 credits (free tier) / 5 credits (pro tier) when using API key authentication. Rate limits apply per-second and per-minute as indicated in response headers.","tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market"],"capabilities":["perp-pnl-leaderboard","hyperliquid-perps","trader-ranking","realized-pnl","unrealized-pnl","roi-calculation","smart-money-filtering","token-god-mode","x402-payment"],"categories":["blockchain-analytics","trading"],"synonyms":["perpetual PnL leaderboard","Hyperliquid trader ranking","perp profit loss","derivatives leaderboard","perp trader performance","Nansen TGM perp PnL"],"warnings":["No standalone documentation page found at api.nansen.ai/docs — schema is inferred entirely from OpenAPI spec","Premium labels parameter behavior may change in future releases (default switching from true to false)"],"endpointUrl":"https://api.nansen.ai/api/v1/tgm/perp-pnl-leaderboard","protocol":"mpp","transport":"http","auth":{"type":"mpp","details":{"realm":"api.nansen.ai","intent":"charge","method":"tempo","service_methods":{"tempo":{"assets":["0x20c000000000000000000000b9537d11c60e8b50"],"intents":["charge"]}}}},"qualityScore":"0.880","qualityRationale":"Full OpenAPI 3.1 schema with detailed request/response models, clear pricing ($0.05 via x402), endpoint confirmed live via 402 MPP challenge. Docs are comprehensive from the OpenAPI spec. Minor deduction because no standalone documentation page was crawlable and response schema references aren't fully expanded inline.","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-19T15:52:49.218Z","embedding":[-0.035125732,0.022277832,0.039245605,0.0067214966,0.025177002,-0.031280518,-0.059539795,0.039367676,0.052215576,0.011314392,0.0028820038,0.016311646,-0.003396988,-0.057861328,0.030685425,0.0067214966,-0.03036499,0.0015554428,-0.05392456,0.08306885,0.044403076,-0.03302002,-0.024917603,0.024108887,-0.022781372,-0.012649536,0.008712769,0.003232956,0.0032806396,-0.027175903,0.0713501,-0.031707764,0.020767212,-0.0046958923,0.0096588135,-0.019989014,0.032318115,0.037261963,0.016326904,0.0066490173,-0.0055503845,-0.006980896,-0.0009007454,0.007698059,-0.03479004,0.013763428,-0.006095886,-0.023513794,0.041259766,0.041290283,-0.033691406,0.006259918,-0.027420044,0.032165527,0.031402588,0.0015134811,0.0002527237,0.010566711,0.011146545,-0.031585693,-0.004219055,-0.050598145,0.06347656,-0.03543091,-0.028701782,0.010360718,-0.054107666,0.060455322,0.017745972,0.07159424,0.043426514,-0.0001654625,0.0063819885,-0.008560181,-0.01637268,0.0038108826,-0.019699097,0.023208618,0.008094788,-0.031402588,-0.011688232,-0.011459351,-0.015235901,-0.004459381,0.027755737,-0.029769897,-0.008918762,-0.044891357,-0.0146102905,-0.000106573105,-0.036743164,-0.06173706,0.0013933182,-0.0010623932,0.0056114197,-0.0155181885,0.016784668,0.02204895,-0.014663696,0.022079468,0.0035648346,0.017288208,-0.01133728,-0.027786255,0.015686035,0.08288574,-0.017456055,0.0039978027,0.0131073,-0.02432251,-0.07348633,0.0046577454,-0.014122009,0.005203247,0.02432251,0.002916336,-0.049224854,0.040985107,0.0038089752,0.009147644,-0.03543091,-0.0027256012,0.075683594,-0.0135269165,-0.03302002,-0.0067481995,-0.0026817322,-0.04058838,0.025054932,0.002626419,-0.011131287,0.035461426,0.012718201,-0.03894043,-0.030578613,-0.005329132,-0.009132385,-0.0030727386,0.010154724,-0.049926758,0.028198242,0.00116539,-0.0066566467,0.015289307,-0.08190918,0.021774292,-0.0068359375,-0.004535675,-0.04269409,0.016677856,0.0060806274,-0.039733887,-0.030441284,0.0053634644,-0.00573349,-0.0031433105,0.048095703,0.021652222,-0.016433716,-0.016036987,-0.043151855,0.06866455,-0.008239746,0.011146545,-0.003446579,0.04647827,0.016082764,-0.040496826,-0.079956055,-0.011978149,-0.009979248,-0.024627686,0.018997192,-0.054473877,-0.010848999,-0.018310547,-0.026916504,0.051727295,-0.007007599,-0.022598267,-0.025985718,0.0104522705,0.015945435,-0.055419922,-0.029541016,0.03137207,-0.016052246,0.040771484,-0.0010032654,0.055267334,0.026763916,0.05618286,0.045166016,0.031311035,-0.087646484,0.008132935,0.035705566,0.0335083,-0.012413025,-0.018814087,0.01084137,-0.009414673,0.008926392,0.025543213,0.0011997223,0.020843506,0.0048294067,-0.044799805,0.025680542,-0.0053710938,0.056121826,0.045532227,0.013206482,0.0034484863,0.000092983246,-0.024642944,-0.03036499,0.056488037,0.030929565,0.016418457,0.02432251,0.015625,-0.029632568,-0.018737793,-0.049591064,0.035949707,0.06903076,-0.011054993,0.009994507,-0.054992676,0.010246277,0.044158936,-0.027359009,-0.02420044,0.02456665,-0.02027893,-0.008293152,-0.04019165,0.016281128,-0.019546509,-0.001996994,0.015235901,0.009399414,-0.017578125,0.06512451,-0.019210815,-0.025848389,-0.04058838,0.062561035,0.013328552,-0.006252289,0.0004298687,-0.02432251,-0.023391724,-0.011619568,-0.0079574585,-0.012458801,0.0090789795,-0.026229858,-0.06555176,0.023986816,0.009048462,-0.03186035,-0.0027389526,0.0037002563,-0.011985779,-0.021331787,0.00092315674,-0.061431885,0.0025577545,0.017425537,0.03515625,0.009719849,-0.007411957,-0.032348633,0.02027893,0.03427124,-0.008651733,-0.010681152,0.014205933,-0.017333984,0.0287323,0.023986816,0.011734009,-0.0012044907,0.008682251,0.037994385,0.021575928,0.026306152,-0.02619934,-0.014976501,-0.014083862,0.07159424,-0.017318726,0.031829834,0.007293701,0.036712646,-0.041992188,0.0093688965,-0.0060157776,0.0026073456,0.00566864,-0.033721924,-0.05001831,-0.0062294006,-0.021774292,0.014976501,-0.009674072,-0.03845215,-0.057159424,-0.029083252,0.05343628,0.014434814,-0.028060913,-0.018966675,-0.016921997,0.035339355,-0.023117065,-0.014030457,-0.012496948,0.0059318542,-0.05795288,0.0015602112,0.02407837,0.01285553,0.024291992,0.0070152283,-0.037719727,0.022903442,-0.014518738,0.068603516,0.0052871704,-0.024932861,-0.022949219,-0.040130615,-0.00010865927,0.029388428,0.0071907043,0.009986877,-0.008232117,-0.01235199,-0.044006348,-0.011886597,-0.030014038,0.061950684,0.0131073,0.023147583,0.040985107,0.0060691833,-0.01864624,-0.0736084,0.002861023,0.014274597,0.036621094,0.019546509,-0.01713562,0.0178833,-0.033325195,-0.043395996,0.01890564,-0.050933838,-0.015235901,0.0040512085,-0.013801575,0.03479004,-0.022735596,-0.039764404,-0.048950195,0.027740479,-0.037902832,0.016845703,0.014526367,0.041870117,-0.00062942505,0.004814148,0.0017299652,0.017120361,0.030761719,-0.0072517395,-0.0017051697,0.029251099,-0.02192688,-0.019973755,0.013046265,0.00970459,0.04083252,0.016601562,-0.0032539368,-0.057403564,0.0127334595,0.02394104,-0.018951416,-0.019805908,-0.014625549,0.016693115,0.0019445419,0.03540039,0.058563232,0.002281189,0.02267456,-0.061523438,0.030578613,-0.031219482,-0.07696533,0.002286911,-0.020889282,0.008728027,0.0019893646,0.010124207,0.003414154,0.029464722,0.008308411,-0.0025119781,-0.012138367,0.017715454,-0.011581421,0.025161743,-0.00003582239,-0.0025672913,0.027069092,0.030548096,-0.079711914,0.032928467,-0.003068924,-0.05618286,-0.001613617,0.043823242,-0.043060303,-0.020065308,-0.039886475,0.000518322,0.03201294,0.038635254,-0.034210205,-0.045043945,-0.015686035,0.005252838,0.030715942,-0.019699097,0.036712646,0.005882263,-0.014892578,-0.02041626,-0.027053833,-0.041656494,-0.0027122498,0.024917603,-0.02255249,0.0066070557,-0.04296875,-0.0146102905,0.05331421,0.032562256,-0.009773254,-0.0016117096,-0.04321289,0.05758667,0.0048675537,0.0149383545,0.005252838,-0.019821167,-0.000107467175,0.036621094,-0.00440979,0.008552551,-0.023498535,-0.04626465,-0.005455017,0.011924744,0.0005464554,-0.023345947,-0.035064697,0.03137207,-0.019226074,-0.0126953125,0.016143799,-0.01134491,0.030654907,0.0030994415,-0.023330688,0.008125305,-0.05596924,-0.07519531,-0.016220093,0.053588867,0.07739258,0.020904541,-0.021316528,-0.101623535,-0.01713562,0.023147583,-0.0049438477,0.05038452,-0.016143799,-0.031585693,-0.020095825,-0.02432251,-0.042144775,0.03314209,-0.02470398,0.034057617,-0.050598145,0.02645874,0.021636963,0.042053223,0.015991211,0.0004079342,-0.007118225,-0.023880005,0.093933105,-0.03857422,0.026611328,0.0032863617,0.017974854,-0.030410767,0.0022335052,-0.027679443,0.025039673,-0.0035877228,-0.012542725,0.043151855,0.0012340546,-0.0090789795,-0.027160645,0.017333984,-0.03515625,-0.06463623,-0.030227661,-0.0030822754,-0.044067383,0.032409668,-0.0013275146,-0.0012025833,0.06173706,-0.03491211,0.014122009,-0.017578125,-0.023254395,-0.045532227,-0.012184143,-0.018188477,-0.002412796,-0.00044989586,-0.020309448,0.03857422,-0.015342712,0.06274414,0.0043144226,0.01285553,0.01902771,-0.006881714,-0.025772095,0.02798462,-0.0010900497,-0.028900146,-0.014137268,-0.017913818,-0.0231781,0.052459717,0.0052719116,0.01663208,0.008659363,0.015991211,0.001411438,0.0051956177,0.011688232,0.0124435425,-0.021057129,-0.0073051453,0.026824951,0.0019483566,-0.014381409,0.014556885,-0.046783447,0.06896973,0.0024299622,-0.011070251,0.013519287,0.054992676,-0.0049591064,-0.034973145,-0.00006651878,-0.008056641,0.026260376,-0.025650024,0.062561035,-0.028839111,0.01651001,-0.032196045,0.02255249,-0.00060129166,-0.025466919,-0.017059326,-0.006011963,-0.014923096,-0.025985718,0.0390625,-0.00932312,0.0087890625,-0.046813965,-0.010185242,0.014839172,-0.042663574,-0.018310547,-0.042114258,0.012641907,0.01725769,0.02508545,-0.0340271,-0.019439697,-0.03149414,-0.0040626526,-0.015434265,0.010864258,-0.018737793,0.048187256,-0.014175415,0.02973938,0.009536743,-0.0022716522,-0.0026130676,-0.016815186,-0.002861023,0.010658264,0.016281128,-0.014823914,-0.0184021,-0.023406982,-0.016159058,0.03753662,-0.01222229,0.009262085,0.012626648,-0.015289307,0.024353027,-0.02079773,0.00038552284,0.0072784424,0.01361084,-0.052520752,0.011497498,0.03463745,-0.0059890747,-0.0103302,-0.011306763,-0.019424438,-0.019104004,-0.007843018,-0.006504059,-0.02180481,-0.0056152344,0.011009216,0.032562256,-0.008491516,0.007911682,-0.012901306,-0.04598999,-0.004787445,-0.030578613,0.0340271,-0.0104599,0.013221741,-0.00083065033,0.01625061,-0.02027893,0.018753052,0.01121521,0.03161621,0.0018939972,0.019210815,-0.01928711,0.080444336,0.01727295,-0.016677856,-0.015167236,-0.0138549805,0.00894165,-0.033355713,0.00079345703,-0.010124207,-0.00081014633,0.018432617,-0.04650879,-0.021026611,-0.0039405823,-0.019943237,-0.0028762817,0.018875122,0.01361084,-0.0038852692,0.00737381,0.007610321,-0.015220642,-0.039642334,0.015945435,-0.00274086,0.015029907,0.039855957,0.009178162,0.010734558,-0.007419586,-0.020706177,-0.036712646,-0.07702637,-0.009391785,0.0043029785,0.01902771,0.013305664,0.01272583,0.005203247,-0.042755127,0.056671143,-0.020507812,0.0057029724,-0.029922485,0.040374756,-0.010246277,-0.018218994,0.031341553,-0.010772705,0.003774643,0.03439331,0.0003941059,0.02015686,0.029632568,0.018112183,0.02041626,0.03302002,0.006679535,-0.015556335,0.00004273653,-0.04345703,-0.048583984,-0.016799927,0.0034770966,-0.0211792,-0.015167236,-0.006412506,-0.010322571,0.005504608,-0.00920105,-0.017791748,-0.018417358,-0.0073127747,0.012557983,-0.0052604675,0.025466919,0.024154663,0.025634766,-0.011657715,-0.030334473,0.011291504,0.025878906,0.03741455,0.0046844482,-0.013153076,-0.017532349,-0.032104492,0.010414124,-0.0085372925,0.00048971176,0.021057129,-0.0079574585,0.027008057,0.017318726,-0.003660202,-0.005218506,0.016540527,-0.0016431808,-0.062805176,-0.011306763,-0.004928589,0.0016908646,-0.014694214,0.04736328,-0.03277588,0.007865906,-0.017227173,0.008720398,-0.007888794,-0.009559631,-0.02406311,0.026885986,-0.013290405,-0.015808105,-0.020935059,0.0020809174,-0.029769897,-0.021392822,0.00016498566,-0.048706055,-0.01499176,0.0010738373,-0.022766113,0.0129470825,0.03652954,0.0011148453,-0.066589355,-0.032958984,0.015686035,-0.025604248,0.0206604,-0.012413025,-0.01171875,0.01876831,-0.0423584,-0.011192322,0.039520264,-0.05206299,0.018051147,-0.021331787,0.03591919,-0.000036478043,0.042297363,0.013961792,0.015365601,-0.044067383,-0.057373047,-0.007621765,0.012336731,0.014465332,-0.025146484,0.021362305,-0.0059814453,0.02381897,0.039642334,-0.027236938,0.022476196,0.028869629,0.016952515,0.011116028,0.031311035,0.0077171326,-0.007041931,-0.01864624,0.018051147,-0.009559631,0.014587402,-0.032562256,0.029296875,0.021499634,0.014137268,-0.022262573,-0.029251099,0.02331543,0.016906738,0.014190674,0.008155823,0.01689148,0.025268555,-0.00630188,-0.00031399727,0.016433716,0.018722534,-0.0033626556,-0.0005927086,-0.011306763,-0.021057129,0.009475708,-0.006416321,-0.025527954,-0.014694214,0.02166748,-0.024810791,-0.028198242,0.018096924,0.015594482,-0.0050811768,0.028137207,-0.0024967194,0.019592285,0.028869629,-0.022125244,0.030410767,-0.009864807,0.0037879944,-0.0035686493,0.012931824,-0.0041160583,0.021606445,-0.003818512,0.025039673,-0.0054969788,-0.004333496,-0.023834229,0.01486969,-0.046020508,0.035064697,-0.029251099,0.011024475,-0.0018482208,0.026275635,-0.026641846,-0.009902954,0.03262329,0.0110321045,-0.015808105,0.039642334,0.005897522,0.005542755,0.04638672,-0.0063705444,-0.0023498535,0.022628784,0.016601562,0.004058838,-0.009674072,-0.0046424866,0.022338867,-0.0018129349,0.023483276,0.035980225,-0.021133423,0.03466797,0.0317688,0.017105103,-0.025909424,-0.0010519028,-0.0068130493,-0.025741577,0.0028095245,0.00039482117,0.0074806213,0.0032043457,0.016433716,-0.01612854,0.0061149597,-0.058380127,0.020431519,-0.01638794,-0.037384033,0.011917114,0.0074806213,0.031585693,0.0014801025,0.025512695,0.0075569153,-0.015419006,0.03164673,0.05026245,0.01727295,0.01675415,0.013877869,-0.005256653,0.009086609,-0.006752014,-0.00030970573,-0.012283325,0.04916382,-0.043914795,-0.009246826,-0.042236328,0.011299133,-0.023620605,0.0003490448,-0.011360168,0.038635254,0.0033569336,0.056884766,0.00869751,0.014526367,0.0001937151,-0.023849487,-0.050079346,0.026473999,-0.012825012,-0.001496315,0.00466156,-0.014587402,-0.0013875961,-0.0018568039,0.02230835,-0.0025463104,0.041168213,0.061920166,0.015686035,0.0051116943,0.009254456,0.0053138733,0.03768921,0.0032405853,0.047912598,-0.017410278,-0.019515991,0.022003174,0.030548096,0.0053253174,0.021438599,0.04525757,0.0036468506,0.013870239,0.032073975,-0.0066947937,-0.004928589,0.033111572,-0.028762817,0.0062789917,0.022964478,0.03567505,0.0046081543,-0.0024814606,-0.0057258606,-0.008407593,-0.02456665,-0.03237915,0.036346436,0.06982422,-0.0077438354,0.0018901825,-0.03527832,0.023620605,-0.022842407,-0.048095703,0.00749588,0.0046081543,0.0026474,-0.0038928986,0.00945282,-0.024139404,0.007083893,-0.0262146,-0.0055732727,-0.029632568,0.0023784637,0.018112183,0.016296387,0.0060539246,-0.03656006,0.0020523071,0.0033035278,0.031585693,0.0026416779,0.0015535355,0.0055503845,0.017211914,0.010032654,-0.024032593,0.036987305,0.029876709,0.0043144226,-0.016677856,0.024124146,0.017471313,-0.010635376,0.033691406,-0.0025920868,-0.009895325,0.015327454,0.023117065,0.007575989,-0.017089844,0.010055542,0.0055656433,0.028442383,0.017700195,0.0413208,-0.0049819946,-0.024993896,0.020217896,0.007068634,-0.0019226074,0.005340576,-0.01424408,0.0012588501,0.003780365,0.03942871,0.015731812,0.0013799667,-0.04171753,0.003490448,0.0073547363,0.0061149597,-0.026260376,0.047180176,0.016860962,0.010757446,0.021102905,-0.005191803,0.04119873,-0.00617218,0.02142334,0.010223389,-0.011360168,0.0060272217,0.0049858093,0.027786255,0.02130127,0.029418945,0.03451538,0.023040771,0.012573242,-0.016357422,0.014732361,0.01309967,0.013801575,-0.0077590942,-0.019165039,0.02104187,0.009254456,-0.014053345,0.01322937,0.010787964,0.014205933,0.0024356842,-0.00932312,0.001912117,0.003648758,-0.000082075596,0.0087890625,0.0064353943,0.03970337,-0.018997192,0.050079346,0.015449524,-0.03717041,-0.011543274,0.014190674,-0.0029659271,-0.0031757355,0.014472961,-0.01663208,-0.0007376671,0.0062675476,0.04623413,0.024810791,0.02607727,0.00749588,0.0023078918,0.0062294006,-0.008956909,0.019348145,-0.013839722,0.008384705,0.0025024414,-0.018997192,-0.016860962,-0.039276123,0.02658081,-0.02381897,0.018981934,-0.026748657,-0.021240234,0.012428284,-0.009498596,0.04208374,0.009635925,-0.022109985,0.076660156,0.00040197372,-0.015029907,0.0010404587,-0.04043579,0.04156494,0.014030457,-0.017074585,0.016906738,0.0016031265,-0.000109910965,0.03491211,0.022109985,-0.008232117,0.036621094,-0.0038661957,-0.0027885437,-0.0015554428,0.015365601,0.013839722,0.0058517456,0.00831604,0.029953003,0.00016486645,-0.00995636,-0.0006465912,-0.011711121,0.031585693,0.0074882507,0.0012378693,0.0099105835,-0.023925781,-0.00013172626,0.025787354,0.00283432,-0.005432129,0.0008845329,0.034729004,0.0022068024,0.02003479,0.006641388,-0.010887146,0.0023422241,0.015296936,-0.022155762,-0.00046682358,0.010292053,0.037200928,-0.012886047,-0.015083313,-0.024169922,0.0034980774,0.029678345,-0.008483887,0.018966675,0.036254883,0.019210815,-0.0062446594,0.0037574768,-0.011070251,-0.017227173,0.040222168,-0.03164673,0.004306793,0.005622864,-0.014274597,0.009315491,0.0057144165,-0.022201538,0.005619049,0.012756348,0.0151901245,-0.010620117,0.015235901,0.028579712,-0.010971069,-0.0209198,0.023544312,-0.009468079,-0.0020389557,-0.016677856,0.0063438416,0.017166138,0.00063085556,-0.03778076,0.015823364,0.013206482,0.021011353,-0.031951904,0.008232117,-0.03274536,0.018554688,-0.009941101,-0.02935791,-0.006866455,-0.0064926147,-0.025314331,0.0012245178,0.032409668,0.0068206787,0.014717102,-0.004928589,0.025665283,0.03515625,-0.0069274902,-0.0042266846,0.0004208088,0.032043457,-0.048553467,-0.027709961,0.020690918,-0.01889038,0.028793335,-0.0075149536,0.016937256,0.03640747,0.0055885315,0.00157547,-0.022705078,0.026428223,0.027053833,0.0032539368,-0.0039978027,0.03225708,0.01637268,0.020507812,0.024368286,-0.0118255615,-0.0044288635,-0.006252289,-0.00073862076,-0.00459671,0.02809143,-0.003736496,-0.036254883,0.018310547,0.0016860962,-0.023803711,-0.0024089813,0.018966675,-0.0178833,-0.012130737,0.009902954,-0.010414124,0.01965332,0.03302002,0.0028190613,-0.020217896,-0.0017499924,-0.019348145,-0.0335083,0.018218994,0.010726929,0.018722534,0.026290894,-0.008811951,-0.012046814,-0.011947632,0.0034217834,0.0115737915,0.02027893,-0.030136108,-0.016540527,-0.025131226,0.0025577545,-0.004524231,-0.019729614,0.010093689,0.025924683,0.040374756,-0.0042762756,-0.013580322,0.010437012,-0.008720398,0.008369446,0.018966675,-0.007461548,-0.009216309,-0.014625549,-0.034851074,-0.0024604797,-0.032043457,0.011108398,-0.02532959,0.011001587,-0.024169922,-0.0014047623,-0.002527237,0.054107666,0.021728516,0.034698486,-0.03640747,-0.006626129,0.0088272095,0.038757324,0.038726807,-0.007171631,0.008331299,-0.0048980713,0.0024318695,0.019439697,0.010658264,0.006259918,0.003774643,-0.033233643,0.017837524,0.002128601,-0.017227173,-0.0053215027,0.013870239,-0.008850098,0.022994995,-0.0013694763,0.007286072,-0.01448822,-0.018173218,-0.026748657,0.019622803,-0.0019664764,0.00058555603,0.004749298,-0.00605011,-0.026397705,-0.0025577545,0.010192871,0.01651001,0.014640808,0.0001487732,-0.017181396,0.025985718,-0.0003900528,-0.06237793,-0.0017299652,0.0015172958,0.0140686035,-0.03326416,0.035339355,-0.008728027,-0.0010099411,0.020828247,0.018508911,-0.013748169,0.025009155,0.020996094,-0.004096985,-0.049926758,0.046142578,0.002155304,-0.016738892,-0.028305054,0.0035247803,0.02708435,0.011222839,-0.008056641,0.025863647,-0.020065308,0.019805908,0.0044288635,-0.0066986084,0.020812988,-0.010856628,0.0061950684,-0.0077781677,-0.002418518,-0.026412964,0.041015625,-0.021362305,0.004245758,-0.022583008,-0.0059051514,0.041900635,0.031402588,0.016036987,0.0029449463,0.0030231476,0.025558472,0.012763977,-0.007286072,0.0087890625,-0.018692017,0.015640259,0.006465912,-0.008033752,0.014762878,-0.0158844,-0.018325806,-0.013786316,-0.008613586,0.034088135,-0.021194458,-0.00894928,0.012626648,-0.029525757,0.0033817291,-0.0045318604,-0.027633667,0.015464783,-0.04107666,0.010566711,-0.002702713,0.009567261,-0.012702942,0.010284424,-0.0018720627,0.0031547546,-0.0024166107,0.01210022,0.018859863,0.008735657,0.0016889572,-0.0134887695,-0.0010681152,0.005870819,-0.005882263,0.029251099,-0.0011043549,-0.006919861,0.01361084,0.007331848,0.026657104,0.02859497,0.023117065,0.042144775,0.025894165,-0.0038146973,0.025985718,-0.0053100586,0.020462036,0.0068206787,-0.026107788,0.014297485,-0.0048332214,0.009674072,0.019012451,-0.003648758,0.04852295,0.06286621,-0.010597229,0.05316162,-0.04675293,-0.016952515,-0.013366699,-0.010299683,-0.0413208,-0.004234314,0.011192322,-0.0016021729,-0.005809784,-0.008621216,0.009429932,0.015396118,0.053833008,-0.018814087,-0.0055503845,0.020584106,-0.0073928833,0.008712769,-0.0082473755,-0.043304443,0.010879517,0.004890442,0.01689148,-0.022323608,0.03955078,-0.03302002,0.0003452301,0.015449524,-0.037719727,-0.042816162,0.016098022,0.037353516,-0.0014467239,0.005844116,-0.0023155212,0.0010280609,0.011581421,0.0012435913,-0.01687622,0.0107421875,-0.0020580292,0.027755737,0.031921387,0.014541626,-0.003753662,0.041107178,0.0006380081,-0.021438599,0.0211792,-0.019882202],"createdAt":"2026-04-18T19:59:15.558Z","updatedAt":"2026-04-22T02:45:05.536Z","lastSeenAt":"2026-04-22T02:45:05.536Z","tsv":"'0.05':138 '5':150 '50':146 'Hyperliquid trader ranking' 'Nansen TGM perp PnL' 'accept':78 'address':92 'along':58 'amount':65,120 'api':156 'appli':161 'authent':158 'avail':131 'btc':83 'call':140 'classif':129 'complet':50 'contract':14,28,41,74 'cover':71 'credit':147,151 'current':56 'data':70 'date':87 'derivatives leaderboard' 'e.g':82 'endpoint':30,77 'eth':84 'exclus':75 'filter':90 'free':148 'header':173 'hold':57,119 'hyperliquid':12,26,43,72 'hyperliquid-perps' 'indic':170 'key':157 'label':97,126 'limit':160 'metric':118 'minut':168 'money':96,128 'netflow':64 'number':100 'option':89,134 'pagin':104 'paramet':105,135 'pattern':68 'per':139,163,167 'per-minut':166 'per-second':162 'percentag':61 'perform':36 'perp':13,27 'perp profit loss' 'perp trader performance' 'perp-pnl-leaderboard' 'perpetu':2,16,40,73 'perpetual PnL leaderboard' 'pnl':8,22,93,112,114,116 'posit':62,98,121 'premium':125 'price':136 'pro':152 'profit':48,54 'profit/loss':35 'protocol':144 'rang':88,94 'rank':1,15,31 'rate':159 'realiz':5,19,47,111 'realized-pnl' 'respons':172 'result':106 'return':45 'roi':60,117 'roi-calculation' 'second':164 'smart':95,127 'smart-money-filtering' 'sol':85 'sort':109 'specif':11,25,39 'symbol':81 'tier':149,153 'token':80 'token-god-mode' 'total':115 'trade':51,67,102 'trader':3,17,32,91 'trader-ranking' 'unreal':7,21,53,113 'unrealized-pnl' 'use':155 'valu':63,99,122 'via':141 'x402':143 'x402-payment'","prices":[{"id":"a1a4825e-7a14-4734-bea1-39ea321dfe75","listingId":"be9075ab-4844-45c9-90f7-24eb57cdcba5","amountUsd":"0.05","unit":"per_call","nativeCurrency":"pathUSD","nativeAmount":"50000","chain":"tempo","payTo":null,"paymentMethod":"mpp-tempo","isPrimary":true,"details":{"realm":"api.nansen.ai","intent":"charge","method":"tempo","dynamic":false,"decimals":6,"unit_type":null,"amount_hint":null,"raw_payment":{"amount":"50000","intent":"charge","method":"tempo","currency":"0x20c000000000000000000000b9537d11c60e8b50","decimals":6,"description":"Perp PnL leaderboard for a token"},"asset_contract":"0x20c000000000000000000000b9537d11c60e8b50"},"createdAt":"2026-04-18T19:59:15.558Z"}],"sources":[{"listingId":"be9075ab-4844-45c9-90f7-24eb57cdcba5","source":"mpp_dev","sourceId":"nansen:POST:/api/v1/tgm/perp-pnl-leaderboard","sourceUrl":"https://mpp.dev/api/services","isPrimary":true,"firstSeenAt":"2026-04-18T19:59:15.558Z","lastSeenAt":"2026-04-22T02:45:05.536Z"}],"details":{"listingId":"be9075ab-4844-45c9-90f7-24eb57cdcba5","quickStartSnippet":"curl -X POST https://api.nansen.ai/api/v1/tgm/perp-pnl-leaderboard \\\n  -H 'Content-Type: application/json' \\\n  -H 'apiKey: YOUR_API_KEY' \\\n  -d '{\n    \"token_symbol\": \"BTC\",\n    \"date\": {\"from\": \"2025-01-01T00:00:00Z\", \"to\": \"2025-01-31T23:59:59Z\"},\n    \"pagination\": {\"page\": 1, \"per_page\": 10}\n  }'","exampleRequest":{"date":{"to":"2025-01-31T23:59:59Z","from":"2025-01-01T00:00:00Z"},"filters":{"pnl_usd_realised":{"min":1000},"position_value_usd":{"min":5000}},"order_by":[{"field":"pnl_usd_total","direction":"DESC"}],"pagination":{"page":1,"per_page":10},"token_symbol":"BTC"},"exampleResponse":{"data":[{"price_usd":97500,"nof_trades":42,"pnl_usd_total":140000.75,"holding_amount":2.5,"netflow_amount":-1,"trader_address":"0x28c6c06298d514db089934071355e5743bf21d60","max_balance_held":5,"pnl_usd_realised":125000.5,"roi_percent_total":0.35,"netflow_amount_usd":-100000,"pnl_usd_unrealised":15000.25,"position_value_usd":243750,"max_balance_held_usd":487500,"roi_percent_realised":0.31,"trader_address_label":"Smart HL Perps Trader [0x28c6c0]","roi_percent_unrealised":0.04,"still_holding_balance_ratio":0.5}],"pagination":{"page":1,"per_page":10,"is_last_page":false}},"schema":{"path":"/api/v1/tgm/perp-pnl-leaderboard","method":"POST","payment":{"amount":"50000","intent":"charge","method":"tempo","currency":"0x20c000000000000000000000b9537d11c60e8b50","decimals":6,"description":"Perp PnL leaderboard for a token"},"description":"Perp PnL leaderboard for a token"},"openapiUrl":null,"agentsTxtUrl":null,"citations":[{"claim":"Endpoint costs $0.05 per call via x402 protocol, or 50 credits (free) / 5 credits (pro)","source_url":"https://api.nansen.ai"},{"claim":"Covers Hyperliquid perpetual contracts only, no chain field needed","source_url":"https://api.nansen.ai"},{"claim":"Returns realized PnL, unrealized PnL, ROI percentages, position values, and trading patterns","source_url":"https://api.nansen.ai"},{"claim":"Endpoint is live (402 MPP challenge returned on HEAD request)","source_url":"https://api.nansen.ai/api/v1/tgm/perp-pnl-leaderboard"}],"useCases":["Identify the most profitable perpetual traders for a given token over a date range","Analyze smart money positioning and performance on Hyperliquid perp contracts","Build copy-trading signals based on top-performing perp traders","Research which traders have the highest ROI on specific perpetual markets","Filter for traders with large unrealized gains to detect conviction positions"],"bestFor":["Quantitative researchers analyzing Hyperliquid perp trader performance","Trading bots that need to identify top-performing perp traders programmatically","Portfolio managers tracking smart money perpetual positions","Agents building derivatives intelligence dashboards"],"notFor":["Spot/DEX token PnL analysis (use /api/v1/tgm/pnl-leaderboard instead)","Real-time trade execution or order placement","Historical price data retrieval (use token-ohlcv endpoint)"],"kindDetails":{"docs":{"homepage":"https://docs.nansen.ai","apiReference":"https://docs.nansen.ai/nansen-api-reference"},"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market"],"realm":"api.nansen.ai","status":"active","methods":{"tempo":{"assets":["0x20c000000000000000000000b9537d11c60e8b50"],"intents":["charge"]}},"provider":{"url":"https://nansen.ai","name":"Nansen"},"categories":["blockchain","data"],"service_id":"nansen","integration":"first-party","service_name":"Nansen","service_description":"Blockchain analytics and smart money intelligence. Token data, wallet profiling, DEX trades, PnL, and flow analysis across multiple chains."},"updatedAt":"2026-04-22T02:45:05.536Z"}}