{"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":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","extra":{"feePayer":"2wKupLR9q6wXYppw8Gr2NvWxKBUqm4PPJKkQfoxHDBg4"},"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-04-22T05:32:33.547Z","lastSeenAt":"2026-04-22T05:32:33.547Z","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-04-22T05:32:33.547Z"}],"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"}}