{"id":"6c59f4bf-ce36-4414-ae99-fe3d8cdc02dd","shortId":"bHy8da","kind":"x402","title":"Rank Hyperliquid perpetual traders by realized and unrealized PnL for a specific contract.","tagline":"Rank Hyperliquid perpetual traders by realized and unrealized PnL for a specific contract.","description":"The Nansen TGM Perp PnL Leaderboard endpoint ranks traders by their profit/loss performance on Hyperliquid perpetual contracts. Given a token symbol (e.g., BTC, ETH, SOL) and a date range, it returns per-trader metrics including realized PnL, unrealized PnL, total PnL, ROI percentages, position value, holding amounts, max balance held, netflow, and number of trades. Results can be filtered by trader address, smart money labels, PnL ranges, and position values, and sorted by any of the returned numeric fields.\n\nThe endpoint is part of Nansen's Token God Mode (TGM) suite and is accessed via POST at `/api/v1/tgm/perp-pnl-leaderboard`. It supports x402 pay-per-request at $0.05 per call, or can be used with a Nansen API key (50 credits on free tier, 5 on pro). Premium labels (smart money, alpha trader) are available via the `premium_labels` parameter. Pagination is supported up to 1000 records per page.\n\nThe endpoint returns JSON with a `data` array of leaderboard records and a `pagination` object. Rate limits are communicated via response headers (per-second and per-minute). The API uses OpenAPI 3.1.0 and the full schema is available at the origin.","tags":[],"capabilities":["perp-pnl-leaderboard","hyperliquid-perps","smart-money-labels","trader-ranking","realized-unrealized-pnl","roi-calculation","x402-payment","pagination","sorting","filtering"],"categories":["blockchain-analytics","defi","trading"],"synonyms":["perpetual PnL leaderboard","Hyperliquid trader ranking","perp profit loss","derivatives leaderboard","Nansen TGM perp PnL","perpetual contract performance","trader PnL ranking"],"warnings":["No external documentation page found at api.nansen.ai/docs — rely on OpenAPI spec for integration details","Premium labels parameter default will change from true to false in a future release"],"endpointUrl":"https://api.nansen.ai/api/v1/tgm/perp-pnl-leaderboard","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":"0x779Ded0c9e1022225f8E0630b35a9b54bE713736","extra":{"name":"USD₮0","version":"1"},"payTo":"0x93053f1e7A5eFEDa532Fe69CbbE43cBEc3A0F13f","amount":"50000","scheme":"exact","network":"eip155:196","maxTimeoutSeconds":300},{"asset":"0xcE24439F2D9C6a2289F741120FE202248B666666","extra":{"name":"United Stables","version":"1","signerAddress":"0x34F7a661160780Ce1346e6D7B96D2bE244590899","assetTransferMethod":"eip3009"},"payTo":"0x93053f1e7A5eFEDa532Fe69CbbE43cBEc3A0F13f","amount":"50000000000000000","scheme":"exact","network":"eip155:56","maxTimeoutSeconds":300},{"asset":"0x8d0d000ee44948fc98c9b98a4fa4921476f08b0d","extra":{"name":"World Liberty Financial USD","version":"1","signerAddress":"0x34F7a661160780Ce1346e6D7B96D2bE244590899","assetTransferMethod":"eip3009"},"payTo":"0x93053f1e7A5eFEDa532Fe69CbbE43cBEc3A0F13f","amount":"50000000000000000","scheme":"exact","network":"eip155:56","maxTimeoutSeconds":300},{"asset":"0x55d398326f99059fF775485246999027B3197955","extra":{"name":"Tether USD","version":"1","signerAddress":"0x34F7a661160780Ce1346e6D7B96D2bE244590899","spenderAddress":"0x3038f7ac3b4D1a3fe886BdCB5cD01e9f6BDd8633","assetTransferMethod":"permit2-exact"},"payTo":"0x93053f1e7A5eFEDa532Fe69CbbE43cBEc3A0F13f","amount":"50000000000000000","scheme":"exact","network":"eip155:56","maxTimeoutSeconds":300},{"asset":"0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d","extra":{"name":"USD Coin","version":"1","signerAddress":"0x34F7a661160780Ce1346e6D7B96D2bE244590899","spenderAddress":"0x3038f7ac3b4D1a3fe886BdCB5cD01e9f6BDd8633","assetTransferMethod":"permit2-exact"},"payTo":"0x93053f1e7A5eFEDa532Fe69CbbE43cBEc3A0F13f","amount":"50000000000000000","scheme":"exact","network":"eip155:56","maxTimeoutSeconds":300},{"asset":"0x754704Bc059F8C67012fEd69BC8A327a5aafb603","extra":{"name":"USDC","version":"2"},"payTo":"0x93053f1e7A5eFEDa532Fe69CbbE43cBEc3A0F13f","amount":"50000","scheme":"exact","network":"eip155:143","maxTimeoutSeconds":300},{"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","extra":{"feePayer":"CjNFTjvBhbJJd2B5ePPMHRLx1ELZpa8dwQgGL727eKww"},"payTo":"J7ZvJEspvwP1oRxQZ7mYmNmT22NTm3GWq3t7HEbvPZYx","amount":"50000","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","maxTimeoutSeconds":300}]},"qualityScore":"0.920","qualityRationale":"Full OpenAPI 3.1.0 schema with detailed request/response models, clear x402 pricing ($0.05/call), live 402 challenge confirmed, and comprehensive endpoint documentation including filters, sort fields, and pagination. Only 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-22T02:48:39.042Z","embedding":[-0.031829834,0.040740967,0.059387207,0.00043845177,0.0028572083,-0.014350891,-0.057739258,0.017715454,0.041137695,-0.0067977905,-0.01586914,0.019363403,-0.0071029663,-0.06738281,0.0119018555,0.0036373138,-0.028671265,-0.00041675568,-0.032226562,0.078552246,0.03503418,-0.022003174,-0.03237915,0.03878784,-0.034729004,0.0017604828,-0.0020160675,0.031311035,0.0022449493,-0.01876831,0.057800293,-0.026809692,0.016479492,-0.007080078,0.02418518,-0.025222778,0.044677734,0.036834717,-0.008331299,0.0013694763,-0.030792236,-0.0064926147,-0.0009007454,0.01940918,-0.018463135,0.004135132,-0.009712219,-0.02784729,0.029312134,0.036346436,-0.036071777,0.004924774,-0.034301758,0.057281494,0.020324707,-0.003873825,-0.010307312,0.009841919,0.03060913,-0.027770996,-0.0149383545,-0.051635742,0.06628418,-0.030563354,-0.0055656433,0.0028495789,-0.048309326,0.050994873,0.021987915,0.07928467,0.045654297,-0.0049209595,0.0013399124,-0.027297974,-0.029510498,0.0013532639,-0.02999878,0.021072388,-0.0051651,-0.03768921,-0.015060425,-0.013259888,-0.03665161,-0.022384644,0.033050537,-0.034423828,-0.00058555603,-0.04650879,-0.02154541,0.013427734,-0.038024902,-0.06958008,0.00299263,0.034362793,0.017227173,-0.03253174,0.0154953,0.024398804,0.0053215027,0.024276733,0.03479004,0.025436401,-0.0009794235,-0.033294678,0.019607544,0.06173706,-0.044036865,-0.005050659,0.0132369995,-0.028320312,-0.088012695,0.008094788,0.0059318542,0.016448975,0.023162842,0.0141067505,-0.03640747,0.03479004,0.012214661,-0.0011863708,-0.028793335,0.011581421,0.053253174,-0.025344849,-0.042633057,0.00048065186,-0.019256592,-0.050994873,0.008575439,0.018554688,-0.008049011,0.019958496,-0.00018775463,-0.0368042,-0.054382324,-0.0010671616,-0.012374878,-0.027236938,0.0070991516,-0.021606445,0.014312744,-0.004802704,-0.0027484894,0.006336212,-0.07940674,0.014350891,-0.025268555,0.003917694,-0.05618286,0.00881958,0.00063562393,-0.019989014,-0.03527832,0.0014562607,-0.0070610046,-0.006477356,0.029510498,0.024337769,-0.03225708,-0.026473999,-0.024887085,0.056884766,-0.00737381,0.015640259,0.0024681091,0.051574707,0.009086609,-0.037750244,-0.075927734,-0.009147644,-0.0036354065,-0.03375244,0.0007071495,-0.034606934,-0.005268097,-0.019577026,-0.02670288,0.04284668,-0.015449524,-0.028366089,-0.02130127,0.0064315796,0.0068092346,-0.03555298,-0.037628174,0.022216797,-0.02909851,0.045959473,0.0011253357,0.04373169,0.012641907,0.035858154,0.0647583,0.028320312,-0.08166504,-0.029800415,0.03878784,0.023086548,0.021209717,0.009796143,0.026626587,-0.0036315918,0.017608643,0.00093984604,-0.020355225,0.021835327,-0.0070343018,-0.043670654,0.031021118,-0.0042266846,0.068725586,0.053771973,0.014945984,-0.00024557114,-0.0018777847,-0.021072388,-0.048095703,0.037231445,0.01576233,0.017852783,0.010353088,0.03463745,-0.04232788,-0.014976501,-0.03314209,0.039642334,0.06347656,-0.017303467,0.015731812,-0.049835205,0.005191803,0.026885986,-0.025939941,-0.020339966,0.032409668,-0.020339966,0.0038776398,-0.049072266,0.029953003,-0.006160736,0.02809143,0.022399902,0.011779785,-0.009780884,0.07220459,-0.018630981,-0.03930664,-0.051208496,0.05429077,0.02520752,0.008872986,0.012481689,-0.033355713,-0.021026611,-0.0034503937,0.007587433,-0.027694702,0.0141067505,-0.020706177,-0.06964111,0.03375244,0.0043144226,-0.032989502,0.00021660328,0.0009660721,0.0065307617,-0.01902771,-0.012130737,-0.056671143,-0.0063323975,0.029312134,0.036468506,0.0027637482,-0.020812988,-0.035614014,0.029205322,0.03881836,-0.016830444,-0.0132751465,-0.0030517578,-0.013977051,0.018203735,0.013458252,0.021957397,-0.011703491,-0.011146545,0.04031372,0.04055786,0.018951416,-0.02734375,-0.006210327,-0.014350891,0.06036377,-0.002122879,0.02784729,0.010932922,0.046936035,-0.030380249,-0.011306763,-0.005970001,-0.028244019,-0.010681152,-0.046020508,-0.06555176,0.0044784546,-0.029434204,0.020828247,-0.008491516,-0.032806396,-0.04257202,-0.033599854,0.04699707,0.018981934,-0.020767212,-0.015686035,0.0013504028,0.024810791,-0.014091492,-0.004562378,-0.011199951,0.0010232925,-0.050567627,-0.0068092346,0.024536133,0.0048294067,0.017028809,0.005996704,-0.040252686,0.017578125,-0.0049705505,0.08068848,-0.0019702911,-0.01133728,-0.0047569275,-0.033203125,0.0262146,0.025650024,0.022216797,0.006099701,0.0067329407,-0.007587433,-0.044952393,-0.0056114197,-0.03781128,0.03994751,0.0076141357,-0.0036964417,0.036376953,0.014297485,-0.0021305084,-0.04840088,0.01007843,0.0423584,0.05508423,0.006980896,-0.026062012,0.020248413,-0.029663086,-0.037384033,0.01889038,-0.0670166,-0.036193848,-0.0036373138,-0.015945435,0.04660034,0.008857727,-0.05218506,-0.031173706,0.051757812,-0.057556152,0.0040016174,0.013336182,0.03881836,-0.011695862,-0.012573242,0.005821228,0.0072746277,0.009513855,0.014389038,0.009490967,0.03149414,-0.029968262,-0.005718231,0.010055542,0.0069770813,0.045074463,0.020507812,-0.0129852295,-0.044921875,0.010253906,0.019012451,-0.027114868,-0.03555298,-0.016082764,-0.0056877136,0.0015249252,0.03414917,0.033996582,-0.007575989,0.022399902,-0.043151855,0.04257202,-0.021530151,-0.0859375,-0.008529663,-0.036010742,0.0068626404,0.024978638,0.016616821,-0.014907837,0.0060272217,0.02394104,-0.0063972473,-0.015930176,0.034179688,-0.012168884,0.017288208,0.011306763,-0.003932953,0.03262329,0.00023853779,-0.06762695,0.02897644,0.013420105,-0.07330322,0.0093688965,0.037719727,-0.03463745,-0.014122009,-0.022994995,0.013847351,0.012268066,0.04055786,-0.03010559,-0.055511475,-0.004550934,0.014282227,0.025466919,-0.016525269,0.054779053,0.012939453,-0.014823914,-0.020996094,-0.015563965,-0.024215698,0.000726223,0.028671265,-0.04727173,0.010292053,-0.05819702,0.0068740845,0.05908203,0.046936035,-0.032684326,-0.012878418,-0.007160187,0.05126953,0.016052246,0.034088135,-0.022018433,-0.0129852295,-0.014297485,0.030944824,-0.011177063,0.0069503784,-0.032928467,-0.049041748,-0.0059776306,0.022277832,0.008613586,-0.01889038,-0.022064209,0.00050640106,-0.018478394,-0.0022792816,0.0395813,-0.03414917,0.02949524,0.0035305023,-0.03164673,-0.0035648346,-0.037902832,-0.08203125,-0.011985779,0.057861328,0.082336426,0.02923584,-0.011871338,-0.07220459,-0.024017334,0.039611816,-0.015136719,0.051086426,-0.0140686035,-0.03656006,-0.0051460266,-0.013145447,-0.04244995,0.018295288,-0.024490356,0.024642944,-0.03866577,0.022247314,0.035064697,0.03933716,-0.011634827,-0.00497818,0.010986328,-0.015853882,0.0826416,-0.052490234,0.034729004,-0.0016422272,-0.0020256042,-0.006122589,-0.00018274784,-0.031951904,0.031463623,-0.0079422,-0.0069122314,0.03491211,0.002981186,-0.014961243,-0.035247803,0.02204895,-0.03552246,-0.041900635,-0.023788452,-0.0005698204,-0.027832031,0.02418518,0.0020694733,0.0067214966,0.055908203,-0.02885437,0.011695862,-0.007156372,-0.029800415,-0.05529785,-0.025344849,-0.013336182,0.004306793,-0.0009918213,-0.0076446533,0.037017822,-0.020736694,0.056030273,0.0077056885,0.02017212,0.020507812,-0.00034856796,-0.031463623,0.03274536,-0.0076446533,-0.037506104,-0.024383545,-0.012825012,-0.019042969,0.042755127,0.022750854,0.011001587,0.006591797,0.028671265,-0.009613037,0.0018434525,0.0032482147,0.014312744,-0.0034275055,-0.022247314,0.026885986,0.009048462,0.0013427734,0.007865906,-0.03668213,0.062805176,-0.01763916,-0.024490356,0.0063476562,0.05871582,0.01159668,-0.04473877,-0.007659912,-0.0041503906,0.028945923,-0.03829956,0.072265625,-0.0368042,0.027908325,-0.03591919,0.0008111,0.017471313,-0.011184692,-0.0075187683,0.0013360977,-0.014030457,-0.020111084,0.0143966675,-0.017578125,0.0066490173,-0.0262146,0.00055885315,-0.00605011,-0.04147339,-0.016296387,-0.02507019,0.017562866,0.0074539185,0.026992798,-0.031021118,-0.013671875,-0.03060913,0.020248413,-0.025772095,-0.0051116943,-0.024169922,0.025405884,-0.014122009,0.039093018,0.0019607544,0.011268616,0.014183044,-0.011917114,0.023513794,0.010070801,0.015670776,-0.00522995,-0.013923645,-0.015487671,-0.044952393,0.043121338,-0.0048179626,0.0068359375,0.026107788,-0.012039185,0.011405945,0.006931305,0.012329102,-0.00015926361,0.023254395,-0.06896973,0.015174866,0.025650024,-0.0031986237,-0.006855011,0.0030822754,-0.02494812,-0.011230469,-0.0071029663,-0.024017334,-0.011917114,-0.005393982,0.0026130676,0.034240723,-0.027618408,0.003522873,-0.010421753,-0.040618896,-0.0234375,-0.017532349,0.03491211,-0.02507019,0.025802612,-0.014411926,0.030456543,-0.033599854,0.01675415,0.008796692,0.03225708,-0.0069770813,0.017608643,0.00064754486,0.078063965,0.016784668,-0.02470398,-0.0060043335,-0.0005750656,0.000034332275,-0.044433594,0.0024909973,0.010917664,-0.001540184,0.023406982,-0.03869629,-0.010276794,0.014549255,-0.015449524,0.0030326843,0.032592773,0.03756714,0.01309967,0.007003784,0.005393982,-0.011604309,-0.033813477,0.02267456,-0.0037498474,0.014984131,0.028320312,-0.0014390945,-0.0032024384,-0.012283325,-0.019485474,-0.03668213,-0.06756592,-0.008262634,0.018127441,0.02015686,0.0047416687,0.008583069,-0.016677856,-0.039367676,0.056365967,-0.03390503,0.006843567,-0.025787354,0.039916992,-0.008476257,-0.00970459,0.03793335,-0.016677856,0.006313324,0.034606934,-0.0019550323,0.01234436,0.02218628,0.0049324036,0.011894226,0.026550293,0.008552551,-0.031021118,0.0064888,-0.029159546,-0.04647827,-0.016662598,-0.013313293,-0.0061035156,0.0061416626,-0.008407593,-0.015975952,0.008232117,-0.018539429,-0.018997192,-0.033691406,-0.018493652,0.011024475,0.0060043335,0.023391724,0.028244019,0.017959595,-0.016433716,-0.031204224,0.009681702,0.015304565,0.030822754,0.0010766983,-0.024093628,-0.009399414,-0.033447266,0.0031642914,0.0011911392,0.01687622,0.011390686,-0.001452446,0.017150879,0.010643005,-0.019104004,-0.0009326935,0.03604126,-0.008224487,-0.050811768,-0.004776001,-0.005405426,-0.0022697449,-0.008300781,0.05947876,-0.038269043,0.010795593,0.0024757385,0.015174866,0.010154724,-0.016860962,-0.029434204,0.022842407,-0.019805908,-0.010787964,-0.005596161,0.0000962615,-0.015304565,-0.030899048,0.0034980774,-0.055664062,-0.012321472,0.002822876,-0.013923645,0.008728027,0.033355713,0.008728027,-0.07354736,-0.037261963,0.004863739,-0.027267456,0.011619568,-0.013801575,-0.0031147003,0.018310547,-0.031280518,-0.017456055,0.039276123,-0.056365967,0.023406982,-0.0040626526,0.03201294,0.002670288,0.045440674,0.0065078735,0.015098572,-0.03060913,-0.0435791,0.002002716,0.0021400452,-0.005054474,-0.011856079,0.025939941,0.003522873,0.011642456,0.044158936,-0.034820557,0.025665283,0.022033691,0.034210205,0.0256958,0.017959595,-0.011245728,0.0017471313,-0.036315918,0.008338928,0.0069618225,0.016601562,-0.023406982,0.022354126,0.018478394,0.015571594,-0.025161743,-0.029510498,0.028549194,0.0031261444,0.020950317,0.020339966,0.016204834,0.0049057007,-0.011711121,-0.002193451,-0.00894928,0.027114868,-0.005458832,0.0025520325,-0.0008506775,-0.019470215,0.005558014,-0.00077962875,-0.036499023,-0.008666992,0.023590088,-0.00774765,-0.029571533,0.005760193,0.0129470825,-0.0054512024,0.024993896,-0.001364708,0.015319824,0.022705078,-0.010574341,0.026473999,-0.0005040169,0.0026226044,0.013442993,0.006504059,-0.0048332214,0.022521973,0.007041931,0.019683838,-0.0054512024,0.009757996,-0.035186768,0.002998352,-0.043395996,0.024795532,-0.019332886,0.025405884,0.011482239,0.034088135,-0.045135498,0.0021572113,0.030410767,0.01777649,-0.041259766,0.037719727,-0.014122009,-0.007335663,0.050598145,-0.013198853,-0.0009841919,0.023773193,0.019882202,-0.014541626,-0.010375977,0.00308609,0.045928955,0.007858276,0.017120361,0.040985107,-0.013916016,0.025817871,0.032165527,0.019729614,-0.0107803345,0.011962891,0.0012521744,-0.015563965,0.01965332,0.0052261353,0.028671265,0.016723633,0.023086548,-0.01701355,0.013458252,-0.049041748,0.007965088,-0.015174866,-0.022735596,0.0015974045,-0.004425049,0.031463623,0.00006771088,0.027954102,-0.0062828064,0.0018672943,0.025878906,0.021865845,0.018875122,0.025787354,0.0018444061,-0.016342163,-0.0029144287,-0.0049705505,0.005672455,-0.006000519,0.043914795,-0.033996582,-0.0027980804,-0.03488159,0.012832642,-0.019195557,0.0028896332,-0.030227661,0.031280518,0.017196655,0.042175293,0.004245758,0.024337769,0.0035934448,-0.018814087,-0.05899048,0.01007843,-0.017684937,0.0016994476,-0.00026392937,-0.008590698,0.0021324158,-0.008140564,0.021408081,-0.008987427,0.05255127,0.050872803,0.012535095,0.014015198,0.0055160522,-0.0119018555,0.0418396,0.011665344,0.04034424,-0.027145386,-0.030029297,-0.0031261444,0.009643555,0.0057411194,0.005126953,0.038848877,0.007633209,0.026657104,0.02909851,-0.00365448,0.003917694,0.010040283,-0.012969971,-0.0066833496,0.045715332,0.034698486,-0.001496315,-0.0107803345,0.012580872,0.0044288635,-0.008354187,-0.034454346,0.021911621,0.06567383,0.008026123,0.011726379,-0.045532227,0.008766174,-0.014503479,-0.040039062,0.0099487305,-0.0009965897,0.012573242,-0.0035266876,0.0045433044,-0.011764526,0.0051727295,-0.04055786,-0.0023517609,-0.011444092,-0.004108429,0.009941101,0.008903503,0.0079422,-0.040283203,0.012428284,-0.0066833496,0.02670288,0.019119263,0.0035324097,0.001335144,0.028930664,0.017410278,-0.021362305,0.03643799,0.018508911,-0.0004351139,-0.021636963,0.015625,0.0018224716,0.000641346,0.04244995,-0.0055999756,0.0012979507,0.006690979,0.029388428,0.0026073456,-0.014602661,0.013427734,0.0017604828,0.016052246,0.009590149,0.042419434,-0.003967285,-0.031143188,0.026855469,0.0038967133,-0.008132935,0.005329132,-0.017059326,0.009689331,0.00033402443,0.05392456,0.028244019,-0.006401062,-0.029876709,-0.0034599304,-0.000059723854,-0.0004878044,-0.032562256,0.0362854,0.020401001,0.021743774,0.027694702,-0.0107421875,0.018157959,-0.009460449,-0.0060043335,0.0064811707,-0.00084114075,0.0071411133,0.0016927719,0.038360596,0.018310547,0.024291992,0.019241333,0.02494812,-0.0057640076,-0.00023293495,0.01939392,0.010566711,0.01876831,-0.00094366074,-0.03050232,0.029022217,0.015380859,-0.014350891,0.0031223297,0.016586304,0.01399231,0.0064086914,-0.021759033,-0.011451721,0.015792847,0.0014848709,0.010528564,0.0048179626,0.032592773,0.0015535355,0.05529785,0.012184143,-0.038909912,-0.016601562,0.021575928,0.008728027,-0.02218628,0.010368347,-0.011543274,-0.0039482117,0.014427185,0.03805542,0.012161255,0.010810852,-0.003232956,0.015975952,0.0079422,-0.012611389,0.0209198,-0.021072388,0.0046081543,0.005001068,-0.020812988,-0.008079529,-0.046081543,0.014640808,-0.024230957,0.012275696,-0.01146698,-0.02696228,0.020935059,-0.010398865,0.03543091,0.016937256,-0.02684021,0.0736084,-0.006511688,-0.013885498,0.018325806,-0.027496338,0.038513184,0.021728516,-0.016921997,0.01927185,0.0070648193,0.013801575,0.02444458,0.00033640862,-0.017745972,0.044006348,-0.015945435,-0.018478394,0.0030651093,0.006919861,0.007881165,0.0077667236,0.008056641,0.033203125,0.0069770813,0.0034275055,-0.0006933212,-0.0019779205,0.028015137,-0.010559082,-0.0018415451,-0.011619568,-0.009460449,0.008285522,0.044189453,0.013336182,-0.011405945,-0.0079422,0.036010742,0.0048446655,0.018951416,0.021224976,-0.031066895,0.009864807,0.00088977814,-0.012893677,-0.016845703,0.017532349,0.02746582,0.0074806213,-0.04055786,-0.023712158,0.004638672,0.009086609,-0.011985779,0.03439331,0.032714844,0.016326904,0.008056641,0.0072364807,-0.017700195,-0.0040397644,0.021560669,-0.030670166,-0.004299164,-0.017364502,-0.023361206,0.012321472,-0.009147644,-0.022857666,-0.01096344,0.000875473,0.016433716,-0.011001587,0.0069122314,0.03378296,-0.01133728,-0.014259338,0.029418945,-0.014541626,0.0048675537,-0.014259338,0.014335632,0.028366089,0.00869751,-0.05053711,0.026931763,0.0019664764,0.008148193,-0.05142212,0.0021133423,-0.026809692,0.011772156,-0.012077332,-0.013198853,0.0015878677,0.003698349,-0.023666382,-0.00013637543,0.03314209,0.006454468,0.018127441,0.0073394775,0.022918701,0.039276123,-0.001578331,-0.0010480881,0.0041160583,0.031707764,-0.048553467,-0.025268555,0.0143966675,-0.01902771,0.017623901,-0.007041931,0.014450073,0.028747559,0.009941101,-0.0058898926,-0.011772156,0.02305603,0.046081543,0.004180908,0.00017976761,0.03326416,-0.005420685,0.006752014,0.006401062,-0.01637268,0.0077819824,-0.007385254,-0.00034618378,-0.018600464,0.027954102,-0.013648987,-0.021850586,0.02507019,0.0041160583,-0.023040771,-0.0060806274,0.014793396,-0.017333984,-0.007232666,0.0018968582,-0.025497437,0.015655518,0.041229248,0.012145996,-0.017974854,0.0058517456,-0.035339355,-0.023101807,0.013389587,0.004081726,0.016937256,0.010215759,-0.021560669,-0.009475708,-0.006778717,0.012207031,0.011695862,-0.001001358,-0.025512695,-0.020874023,-0.027374268,-0.00046110153,-0.013214111,-0.015380859,0.010437012,0.021713257,0.044158936,0.0036888123,-0.014320374,0.014549255,-0.006259918,0.021362305,0.016021729,-0.007507324,-0.00982666,-0.0061912537,-0.01576233,0.008728027,-0.019882202,0.0025367737,-0.052093506,0.019180298,-0.03366089,0.007396698,-0.008308411,0.046661377,0.02420044,0.02003479,-0.050598145,0.0026512146,0.009529114,0.0357666,0.035461426,0.010429382,-0.0017490387,-0.0011262894,0.0020103455,0.03112793,0.019500732,0.0069236755,0.012336731,-0.02130127,0.03164673,0.0019607544,-0.023620605,-0.015411377,0.008872986,-0.016540527,0.037017822,-0.0042419434,0.011146545,-0.012435913,-0.02532959,-0.016098022,0.028625488,0.0051994324,-0.0022716522,-0.004714966,0.0045433044,-0.0284729,-0.014602661,-0.0016641617,0.01574707,-0.004924774,0.008979797,-0.026031494,0.027114868,0.0034942627,-0.055389404,0.011070251,0.020370483,0.014373779,-0.030975342,0.028717041,-0.022659302,0.00024080276,0.018478394,-0.0005555153,-0.009727478,0.021881104,0.024124146,-0.01612854,-0.027648926,0.0368042,0.0011949539,-0.010093689,-0.018753052,0.009269714,0.03050232,0.009796143,-0.0062675476,-0.0029354095,0.000066399574,0.021987915,0.021713257,0.008651733,0.001206398,-0.025878906,-0.013389587,0.00982666,-0.0016975403,-0.025894165,0.045837402,-0.004497528,-0.010719299,-0.020004272,0.0005788803,0.04067993,0.017074585,0.010101318,-0.011734009,0.0040664673,0.021469116,0.00655365,0.011100769,0.016281128,-0.000024676323,-0.00308609,-0.017837524,-0.0042648315,0.01776123,-0.012840271,-0.0335083,-0.020462036,-0.0031661987,0.040222168,0.0025863647,0.0020561218,-0.0032653809,-0.019744873,-0.0088272095,-0.004055023,-0.014465332,0.0206604,-0.041381836,0.02809143,0.0065689087,0.0006608963,-0.01574707,-0.0049705505,-0.016723633,0.00023436546,-0.002811432,0.01914978,0.02166748,0.018157959,-0.0021705627,-0.00023436546,0.0019798279,0.014083862,-0.008514404,0.029464722,-0.0007972717,-0.022064209,0.021499634,0.00047516823,0.018325806,0.03125,0.013084412,0.0413208,0.01928711,0.0030899048,0.03579712,-0.0019035339,0.014923096,0.0017261505,-0.03289795,0.017364502,0.009559631,0.014465332,0.01335144,-0.008506775,0.050231934,0.061950684,0.0018234253,0.05407715,-0.05621338,-0.014587402,-0.0023994446,-0.0026435852,-0.025970459,0.019165039,0.020812988,0.0074539185,-0.014961243,-0.023086548,0.00844574,0.00762558,0.048034668,-0.009925842,-0.009559631,0.012359619,-0.0034313202,0.010604858,0.0017709732,-0.0423584,-0.00762558,0.0062294006,-0.0051498413,-0.010406494,0.04437256,-0.031433105,0.0017328262,0.01739502,-0.012428284,-0.037719727,0.022521973,0.03387451,-0.001865387,-0.0032577515,-0.0036125183,0.002603531,0.016601562,0.0056991577,-0.024627686,0.01576233,-0.006767273,0.01675415,0.047210693,0.007396698,-0.0023021698,0.045532227,-0.009475708,-0.014862061,0.026168823,-0.03274536],"createdAt":"2026-04-21T18:32:40.725Z","updatedAt":"2026-09-14T19:33:03.273Z","lastSeenAt":"2026-09-14T19:33:03.273Z","tsv":"'/api/v1/tgm/perp-pnl-leaderboard':125 '0.05':134 '1000':172 '3.1.0':209 '5':151 '50':146 'Hyperliquid trader ranking' 'Nansen TGM perp PnL' 'access':121 'address':89 'alpha':158 'amount':74 'api':144,206 'array':183 'avail':161,215 'balanc':76 'btc':49 'call':136 'communic':194 'contract':13,26,43 'credit':147 'data':182 'date':54 'derivatives leaderboard' 'e.g':48 'endpoint':33,108,177 'eth':50 'field':106 'filter':86 'filtering' 'free':149 'full':212 'given':44 'god':115 'header':197 'held':77 'hold':73 'hyperliquid':2,15,41 'hyperliquid-perps' 'includ':62 'json':179 'key':145 'label':92,155,165 'leaderboard':32,185 'limit':192 'max':75 'metric':61 'minut':204 'mode':116 'money':91,157 'nansen':28,112,143 'netflow':78 'number':80 'numer':105 'object':190 'openapi':208 'origin':218 'page':175 'pagin':167,189 'pagination' 'paramet':166 'part':110 'pay':130 'pay-per-request':129 'per':59,131,135,174,199,203 'per-minut':202 'per-second':198 'per-trad':58 'percentag':70 'perform':39 'perp':30 'perp profit loss' 'perp-pnl-leaderboard' 'perpetu':3,16,42 'perpetual PnL leaderboard' 'perpetual contract performance' 'pnl':9,22,31,64,66,68,93 'posit':71,96 'post':123 'premium':154,164 'pro':153 'profit/loss':38 'rang':55,94 'rank':1,14,34 'rate':191 'realiz':6,19,63 'realized-unrealized-pnl' 'record':173,186 'request':132 'respons':196 'result':83 'return':57,104,178 'roi':69 'roi-calculation' 'schema':213 'second':200 'smart':90,156 'smart-money-labels' 'sol':51 'sort':99 'sorting' 'specif':12,25 'suit':118 'support':127,169 'symbol':47 'tgm':29,117 'tier':150 'token':46,114 'total':67 'trade':82 'trader':4,17,35,60,88,159 'trader PnL ranking' 'trader-ranking' 'unreal':8,21,65 'use':140,207 'valu':72,97 'via':122,162,195 'x402':128 'x402-payment'","prices":[{"id":"51ec6c26-1e19-426a-9c72-4a6540a76577","listingId":"6c59f4bf-ce36-4414-ae99-fe3d8cdc02dd","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:40.725Z"}],"sources":[{"listingId":"6c59f4bf-ce36-4414-ae99-fe3d8cdc02dd","source":"x402_bazaar","sourceId":"https://api.nansen.ai/api/v1/tgm/perp-pnl-leaderboard","sourceUrl":"https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources","isPrimary":true,"firstSeenAt":"2026-04-21T18:32:40.725Z","lastSeenAt":"2026-09-14T19:33:03.273Z"}],"details":{"listingId":"6c59f4bf-ce36-4414-ae99-fe3d8cdc02dd","quickStartSnippet":"curl -X POST https://api.nansen.ai/api/v1/tgm/perp-pnl-leaderboard \\\n  -H 'Content-Type: application/json' \\\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}},"pagination":{"page":1,"per_page":10},"token_symbol":"BTC"},"exampleResponse":{"data":[{"price_usd":97500,"nof_trades":25,"pnl_usd_total":135025.5,"holding_amount":1.5,"trader_address":"0x28c6c06298d514db089934071355e5743bf21d60","pnl_usd_realised":125000.5,"roi_percent_total":15.5,"pnl_usd_unrealised":10025,"position_value_usd":146250,"roi_percent_realised":12.3,"trader_address_label":"Smart HL Perps Trader","roi_percent_unrealised":3.2}],"pagination":{"page":1,"per_page":10,"is_last_page":false}},"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[{"claim":"Endpoint is POST /api/v1/tgm/perp-pnl-leaderboard with x402 payment at $0.05 per call","source_url":"https://api.nansen.ai"},{"claim":"Supports Hyperliquid perpetual contracts only, with realized/unrealized PnL, ROI, and smart money label filtering","source_url":"https://api.nansen.ai"},{"claim":"Credit cost is 50 (free tier) or 5 (pro tier); premium_labels variant costs 150 pro credits","source_url":"https://api.nansen.ai"},{"claim":"x402 402 challenge confirmed live via POST probe","source_url":"https://api.nansen.ai/api/v1/tgm/perp-pnl-leaderboard"}],"useCases":["Rank the most profitable Hyperliquid perpetual traders for a given token and time period","Identify smart money traders with the highest realized PnL on specific perp contracts","Screen for traders with large unrealized positions on Hyperliquid","Backtest which addresses consistently profit from perpetual trading","Build dashboards showing top perp traders by ROI or total PnL"],"bestFor":["Crypto trading research and alpha discovery on Hyperliquid perpetuals","Identifying smart money perpetual trading patterns","Building trader leaderboards and performance dashboards"],"notFor":["Spot/DEX token PnL analysis (use /api/v1/tgm/pnl-leaderboard instead)","Real-time trade execution or order placement","Non-Hyperliquid perpetual exchanges"],"kindDetails":{},"updatedAt":"2026-04-22T02:48:39.042Z"}}