{"id":"5199fe1f-a1bb-4874-80d4-c4899e8ad33b","shortId":"CycpLH","kind":"mpp","title":"Retrieve open perpetual positions for a token on Hyperliquid via Nansen's blockchain analytics API.","tagline":"Retrieve open perpetual positions for a token on Hyperliquid via Nansen's blockchain analytics API.","description":"This endpoint returns current perpetual contract positions for a specific token on Hyperliquid, sourced from Nansen's blockchain analytics platform. It provides detailed per-position metrics including entry price, mark price, leverage, unrealized PnL, liquidation price, and position value in USD. Results can be filtered by label type (smart money, whales, public figures, or all traders) and further refined with filters on position side (Long/Short), position value, entry price, unrealized PnL, and more.\n\nThe endpoint is part of Nansen's Token God Mode (TGM) suite, which offers comprehensive token-level analytics across multiple chains. It accepts a POST request with a JSON body specifying the token_symbol (e.g., \"BTC\", \"ETH\", \"SOL\") and optional label_type, pagination, filters, and order_by parameters. The response includes a paginated list of position records with address labels from Nansen's wallet profiling system.\n\nPricing is $0.05 per call via the x402 protocol, or 50 credits (free tier) / 5 credits (pro tier) when using a Nansen API key. Rate limits are enforced per-second and per-minute, reported via response headers.","tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market"],"capabilities":["perp-positions","hyperliquid-data","smart-money-filtering","token-god-mode","wallet-labeling","leverage-tracking","pnl-tracking","liquidation-price","pagination","sorting"],"categories":["blockchain-analytics","defi","trading"],"synonyms":["perpetual positions","perp positions","hyperliquid positions","open interest by address","derivatives positions","futures positions","Nansen TGM perp positions"],"warnings":["No live 200-response example was captured; example_response_json is inferred from the OpenAPI schema and field descriptions.","The endpoint only covers Hyperliquid perpetual contracts; other perp exchanges are not supported."],"endpointUrl":"https://api.nansen.ai/api/v1/tgm/perp-positions","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 endpoint description, x-payment-info and x-credit-cost metadata, and a confirmed live 402 MPP challenge. Minor deduction because no actual 200 response sample was captured in the probe and the specific TGMPerpPositionsRequest/Response schemas reference $ref components not fully expanded in the crawl.","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:53:17.050Z","embedding":[-0.041656494,0.021728516,0.056518555,-0.000050663948,-0.008033752,-0.035736084,-0.06536865,0.027542114,0.03817749,-0.027862549,0.0032043457,0.014076233,-0.027435303,-0.03753662,0.03201294,0.01612854,-0.031097412,0.0047416687,-0.019088745,0.07183838,0.022232056,-0.0047416687,-0.03375244,0.027145386,-0.020874023,-0.02961731,0.0007982254,0.031341553,0.013244629,-0.029556274,0.06707764,-0.030685425,0.014602661,0.011398315,0.022735596,0.012016296,0.015640259,0.018096924,-0.020996094,-0.010353088,-0.025222778,-0.01789856,0.010864258,0.011222839,0.0001732111,0.033081055,-0.053955078,-0.027404785,-0.002008438,0.030578613,-0.027923584,-0.007083893,-0.018508911,0.057647705,0.030380249,-0.019454956,-0.024978638,0.03463745,0.011260986,0.0068855286,-0.01763916,-0.07299805,0.07476807,-0.008430481,-0.009605408,0.0072746277,-0.054870605,0.032348633,-0.027709961,0.07116699,0.053741455,0.020568848,-0.02029419,-0.030273438,-0.034057617,-0.001253128,-0.02053833,0.028045654,-0.062683105,-0.023529053,-0.0413208,-0.028579712,-0.050445557,-0.045410156,0.03677368,-0.0075569153,-0.026504517,-0.041168213,-0.060821533,0.012535095,-0.03982544,-0.03866577,0.0031375885,0.017486572,-0.0017547607,-0.04724121,0.028198242,0.02116394,0.031555176,0.011741638,-0.007659912,0.024642944,0.0021133423,-0.036712646,0.016464233,0.054260254,-0.015670776,0.0053215027,0.030639648,0.013717651,-0.068115234,-0.00035381317,-0.005519867,-0.004535675,0.018798828,0.020004272,-0.049926758,0.031021118,0.018569946,-0.016571045,-0.017456055,0.0035705566,0.09295654,-0.024536133,-0.034362793,-0.0118637085,-0.020217896,-0.049621582,0.00315094,0.026611328,-0.010375977,0.020812988,0.0021972656,-0.033935547,-0.04144287,-0.0057640076,-0.019165039,-0.030883789,0.0025424957,-0.015007019,0.029663086,-0.03225708,0.010169983,0.0055885315,-0.10467529,-0.012458801,-0.01600647,-0.008811951,-0.043273926,0.0074539185,0.0016536713,-0.007385254,-0.023620605,-0.028900146,0.0059165955,-0.023422241,0.017990112,0.045684814,-0.038848877,-0.0048446655,-0.060455322,0.07891846,0.020111084,0.03326416,0.0058135986,0.0440979,-0.013549805,-0.04849243,-0.06591797,-0.005027771,0.0075416565,-0.00642395,-0.009132385,-0.04916382,-0.030044556,-0.016937256,-0.002445221,0.018936157,-0.0051116943,-0.01612854,-0.029693604,-0.0054626465,0.04437256,-0.05166626,-0.02961731,0.004058838,-0.028198242,0.08319092,0.02267456,0.06173706,-0.017745972,0.029174805,0.08880615,0.025878906,-0.047454834,-0.017089844,0.0022449493,0.008666992,0.029785156,0.00053977966,0.034423828,-0.014076233,0.025238037,-0.0004723072,-0.025466919,0.03555298,-0.014419556,-0.042755127,0.03869629,0.014282227,0.057006836,0.019515991,-0.036468506,-0.009048462,-0.020309448,-0.0041542053,-0.055541992,0.03326416,-0.008232117,0.008659363,-0.011672974,0.017471313,-0.02848816,-0.011100769,-0.042022705,0.043884277,0.05142212,-0.020904541,0.023162842,-0.05419922,-0.0054969788,0.044891357,-0.008399963,-0.038085938,0.0075187683,-0.015686035,-0.026687622,-0.034362793,0.014251709,-0.035003662,0.01309967,0.00045704842,-0.033294678,0.001083374,0.055023193,-0.009277344,-0.021514893,-0.058288574,0.05984497,0.022109985,-0.00982666,0.01360321,-0.031829834,-0.008575439,0.0032138824,-0.009513855,-0.0068511963,0.024047852,-0.034729004,-0.027130127,0.023468018,0.005970001,-0.02355957,-0.014022827,-0.018112183,-0.0209198,-0.021087646,-0.0026397705,-0.04864502,-0.0013713837,-0.0033836365,0.023468018,-0.00040388107,-0.04550171,-0.08074951,0.047973633,0.024719238,-0.04156494,-0.0031051636,0.012542725,-0.008735657,0.0015144348,0.013320923,0.017318726,-0.0034542084,-0.010025024,0.03164673,0.039276123,-0.0006585121,0.0000346303,0.013168335,-0.019866943,0.061676025,-0.024734497,0.04598999,-0.0054855347,0.057373047,-0.018569946,-0.019088745,-0.04031372,-0.022354126,0.023330688,-0.019332886,-0.09399414,0.029693604,-0.020736694,0.025299072,0.009796143,-0.0146865845,-0.008041382,-0.04647827,0.05593872,0.0032749176,-0.022201538,0.011894226,-0.012771606,0.052368164,-0.0008158684,-0.021133423,-0.022994995,0.01689148,-0.06347656,0.00012242794,-0.014884949,0.0064430237,-0.014007568,-0.005153656,-0.037628174,0.013038635,-0.0009870529,0.04776001,-0.0070495605,0.017288208,-0.017028809,0.00819397,-0.001414299,0.015304565,-0.0060691833,0.024169922,-0.026489258,0.02420044,-0.035949707,0.011009216,-0.037628174,0.022491455,0.008926392,-0.005844116,0.03112793,0.020370483,-0.018218994,-0.05014038,0.01802063,0.024734497,0.035888672,0.027069092,-0.02909851,-0.00034689903,-0.042114258,-0.029663086,-0.011764526,-0.081848145,-0.022750854,0.02017212,0.006916046,0.073791504,-0.021728516,-0.033447266,-0.0256958,0.006362915,-0.06173706,0.009880066,0.0035057068,0.035980225,0.010650635,-0.025115967,0.01285553,0.020446777,0.011314392,-0.008888245,-0.0026378632,0.041992188,-0.022766113,0.011131287,0.02571106,-0.01914978,0.026672363,-0.02961731,-0.001709938,-0.029891968,-0.004272461,0.032928467,-0.03189087,-0.022201538,0.002439499,-0.02583313,0.0008382797,0.027130127,0.042236328,-0.00484848,0.0209198,-0.006866455,0.0056266785,-0.04699707,-0.032287598,-0.03173828,-0.023391724,0.011993408,0.05343628,0.019897461,-0.018554688,-0.0019388199,0.011741638,0.012535095,-0.0054626465,0.02935791,0.0112838745,0.020126343,-0.00029993057,0.0058403015,0.013343811,0.032287598,-0.055725098,0.034942627,-0.0010328293,-0.08355713,-0.0234375,0.04727173,-0.008132935,-0.0023670197,-0.05999756,-0.0035514832,0.022598267,0.04019165,-0.034057617,-0.040924072,0.00039625168,-0.009742737,0.023727417,-0.01889038,0.05218506,-0.0418396,-0.03326416,-0.04550171,-0.020126343,-0.016296387,-0.003742218,0.020980835,-0.041534424,-0.0036125183,-0.04534912,0.0041046143,0.0033130646,0.03604126,-0.015205383,0.018417358,-0.0028648376,0.033569336,-0.02029419,0.04196167,-0.018798828,-0.03793335,-0.014511108,0.01675415,-0.010925293,0.009155273,-0.020126343,-0.006286621,0.013923645,-0.00381279,0.009239197,-0.0016536713,-0.01424408,-0.0024967194,-0.025787354,-0.01285553,0.024658203,-0.016815186,0.026412964,-0.009475708,0.001865387,0.0036563873,-0.017501831,-0.07684326,-0.0022449493,0.037994385,0.07763672,0.026107788,-0.015327454,-0.03933716,-0.03945923,0.026275635,-0.013191223,0.03451538,-0.014076233,-0.048217773,-0.040374756,-0.03643799,-0.04296875,0.038879395,-0.017181396,0.016799927,-0.039031982,0.01209259,0.037872314,0.04916382,-0.015899658,0.012619019,-0.003074646,-0.0074157715,0.08251953,-0.023910522,0.048217773,-0.013626099,0.0054092407,-0.00995636,-0.012763977,-0.04019165,0.028457642,-0.012481689,-0.016464233,0.019683838,0.02684021,0.012008667,-0.02418518,0.009513855,-0.018051147,-0.03253174,-0.033416748,0.019592285,-0.015548706,0.021133423,-0.0049324036,0.010940552,0.054107666,-0.045684814,0.0012235641,-0.0077667236,-0.008712769,-0.049621582,0.0017366409,-0.018707275,-0.012367249,-0.023895264,0.008781433,0.019073486,-0.010017395,0.059173584,0.0019207001,0.01838684,0.024536133,-0.005405426,-0.032989502,0.0211792,-0.00017464161,0.0014476776,0.0011911392,0.0059890747,-0.045410156,0.061462402,0.012619019,0.01374054,0.0011405945,0.030639648,0.0026454926,-0.007019043,0.000009894371,0.017715454,0.0015630722,0.000072300434,0.012390137,0.01197052,-0.01953125,0.038970947,-0.032196045,0.048309326,0.012184143,-0.024780273,-0.012138367,0.051879883,0.024490356,-0.028717041,0.0055770874,-0.0004029274,0.038146973,-0.029129028,0.05682373,-0.025390625,0.03289795,-0.028533936,-0.018569946,0.033691406,-0.004096985,-0.0035133362,0.010002136,-0.036865234,-0.025222778,0.024047852,-0.0113220215,0.023483276,-0.03262329,0.009231567,-0.004295349,-0.045043945,0.021377563,-0.036315918,0.0021839142,0.011627197,0.023605347,-0.0038490295,0.011657715,-0.033569336,0.026565552,-0.021194458,0.0048828125,0.012374878,0.012214661,-0.028198242,0.027328491,0.005592346,0.009429932,0.023925781,-0.010108948,0.022354126,0.016174316,0.025680542,0.0018854141,-0.03515625,-0.02519226,-0.037384033,0.018005371,0.0073890686,-0.029434204,0.030197144,-0.0035572052,0.008880615,0.010025024,-0.0052948,0.051483154,0.0016384125,-0.04421997,-0.01576233,0.0038547516,0.0036182404,-0.0178833,-0.004837036,-0.012176514,-0.018981934,0.007205963,-0.024993896,-0.015899658,-0.009719849,-0.03250122,0.032592773,-0.038879395,-0.0015964508,-0.016525269,-0.017974854,-0.020065308,-0.021011353,0.017929077,-0.049865723,0.0049095154,-0.010940552,0.033050537,-0.02935791,0.027069092,0.00062942505,0.031280518,-0.011291504,-0.012130737,-0.021209717,0.06225586,0.022399902,-0.0057907104,0.0011606216,0.011383057,0.006755829,-0.038879395,0.015914917,0.033416748,-0.000808239,0.020462036,-0.015655518,-0.02935791,0.029510498,-0.015167236,0.023498535,0.016067505,0.05267334,-0.0014448166,-0.0066719055,0.0061302185,0.010108948,-0.034698486,0.028717041,-0.013015747,0.016159058,0.01235199,-0.01108551,0.0036125183,-0.022979736,-0.013320923,-0.036621094,-0.06951904,-0.017547607,0.005558014,0.0256958,0.024765015,0.008216858,-0.0011978149,-0.046783447,0.046539307,-0.028274536,0.000069618225,-0.010520935,0.014411926,-0.009483337,-0.026168823,0.0064964294,-0.0099487305,0.011993408,0.018371582,-0.0087890625,0.004611969,0.024673462,-0.0043144226,0.027694702,0.041290283,0.014793396,-0.0446167,0.0075416565,-0.030090332,-0.05819702,-0.0030498505,-0.02192688,-0.012077332,0.0039482117,-0.0043144226,-0.009017944,-0.0010147095,-0.0035629272,-0.03161621,0.015701294,-0.015487671,0.0065956116,-0.0041275024,0.004535675,-0.008987427,0.025680542,-0.0069732666,-0.016098022,0.00982666,0.027938843,0.025772095,0.0011129379,-0.032928467,-0.010978699,-0.04611206,0.006916046,0.0077667236,-0.0074157715,0.008117676,0.018447876,0.018814087,-0.0076828003,-0.00699234,-0.015365601,0.037017822,-0.012496948,-0.03466797,0.011108398,-0.00724411,0.023101807,0.0053596497,0.053833008,-0.08013916,0.027740479,0.021636963,0.009048462,-0.020217896,0.0026054382,-0.03579712,0.02130127,-0.02407837,0.006378174,0.014289856,0.010253906,0.00995636,-0.020904541,0.003364563,-0.04953003,-0.01928711,-0.0047912598,-0.022918701,0.005001068,0.052368164,-0.0103302,-0.06225586,-0.0129852295,0.021621704,-0.031021118,-0.0003643036,-0.009735107,-0.012817383,0.033233643,-0.01335907,-0.0076065063,0.05441284,-0.05050659,0.006149292,-0.023498535,0.03387451,0.033477783,0.029174805,0.006866455,0.01109314,-0.011787415,-0.036834717,0.014305115,-0.0038833618,0.0071907043,-0.017868042,0.02848816,-0.0076026917,0.0154953,0.031280518,-0.048065186,0.032165527,0.010566711,0.010864258,0.011741638,0.020065308,-0.0043754578,0.0025253296,-0.012611389,-0.016906738,0.018447876,0.01852417,-0.012504578,0.020523071,0.029846191,0.01335907,-0.021697998,-0.034088135,0.0016679764,0.015289307,0.019607544,0.0262146,0.008911133,0.010307312,0.0025978088,0.0128479,-0.0010299683,0.02281189,0.006652832,-0.024276733,-0.018798828,-0.025604248,0.03213501,-0.01158905,-0.012435913,-0.041229248,0.021697998,-0.015853882,-0.0021953583,-0.004547119,0.01574707,0.012680054,0.024047852,-0.011360168,0.030258179,0.0121154785,-0.007434845,0.028945923,-0.00793457,0.014282227,-0.0062065125,-0.0016956329,0.016326904,0.02709961,-0.0034065247,-0.0006465912,0.0029315948,-0.021240234,0.0010585785,-0.0019664764,-0.02557373,0.011955261,-0.007972717,0.0061912537,0.013267517,0.0184021,-0.034362793,-0.029815674,0.013648987,-0.010169983,-0.036865234,0.036743164,0.0071907043,-0.0032024384,0.053222656,0.009269714,0.0090789795,0.0024776459,0.011024475,-0.031097412,-0.012573242,0.0061187744,0.031219482,0.01625061,0.030639648,0.029922485,0.009407043,0.018951416,0.009185791,0.032806396,-0.017837524,0.019760132,-0.012428284,-0.02029419,0.04373169,0.0017366409,-0.013648987,-0.010177612,0.019607544,-0.009017944,0.00056028366,-0.043792725,0.040039062,-0.0012960434,-0.017669678,0.0033168793,-0.0024871826,0.0028476715,0.021759033,0.013679504,0.00687027,-0.015686035,0.018936157,0.038146973,0.030715942,0.018798828,0.027709961,-0.016586304,0.0063209534,-0.0029449463,0.0055656433,-0.005153656,0.03555298,-0.021118164,-0.006126404,-0.026382446,-0.0018119812,-0.049713135,-0.0115356445,0.0052719116,0.054595947,0.015487671,0.0491333,-0.0158844,0.028015137,0.02079773,-0.030410767,-0.07873535,0.0143585205,0.003042221,0.015686035,0.0011787415,0.009346008,-0.0036029816,-0.0030879974,0.0015745163,-0.010375977,0.051361084,0.041931152,0.029327393,0.01676941,0.005077362,0.0069084167,0.033843994,0.0022678375,0.049346924,-0.019012451,-0.041534424,-0.002948761,0.00894928,-0.016799927,0.0058403015,0.057678223,0.0047950745,0.030578613,0.064208984,-0.007774353,-0.021484375,0.016830444,-0.026763916,0.016525269,0.023910522,0.01966858,0.0095825195,-0.003080368,0.023239136,-0.005203247,-0.01373291,-0.02810669,0.028915405,0.07788086,-0.007068634,-0.002811432,-0.031951904,0.022201538,-0.037628174,-0.051330566,0.002357483,-0.012619019,0.016296387,0.0034484863,-0.011260986,-0.014457703,0.000081419945,-0.03274536,-0.024597168,-0.016098022,0.0016002655,0.033569336,-0.0018959045,0.0065078735,-0.037384033,0.017501831,0.010322571,-0.000078737736,0.031341553,0.010803223,0.019577026,0.004425049,0.0029392242,-0.022445679,0.023223877,0.019577026,0.017501831,-0.011009216,0.0061798096,-0.0028076172,-0.008804321,0.03579712,0.016983032,0.023101807,0.012359619,0.028015137,0.019012451,-0.0043640137,0.013244629,0.008918762,0.020385742,0.008148193,0.019058228,-0.005092621,-0.026901245,0.042022705,0.015419006,-0.0059547424,0.0054893494,-0.017120361,-0.000077188015,-0.0063056946,0.03250122,0.011100769,-0.0020542145,-0.0075569153,-0.013626099,0.009880066,0.02015686,-0.0070381165,0.028900146,-0.0015935898,0.010017395,0.031311035,-0.008079529,0.028945923,0.0020751953,-0.00056934357,0.010398865,-0.013664246,-0.017684937,0.0065307617,0.057678223,0.012863159,0.020324707,0.030944824,0.018051147,-0.025039673,-0.015403748,0.0052986145,0.034301758,0.0107040405,-0.011116028,-0.007068634,0.040100098,0.019104004,-0.0031738281,-0.0012950897,0.013641357,0.00094795227,0.013717651,-0.035980225,-0.0067634583,0.007911682,0.013908386,0.016189575,0.0043182373,0.021835327,0.0134887695,0.039154053,0.010910034,-0.024124146,0.004764557,0.023742676,-0.011062622,-0.028869629,0.011306763,0.006904602,-0.0040779114,0.035461426,0.031143188,-0.013214111,0.016677856,0.010070801,0.024932861,0.01889038,-0.016525269,0.0043754578,0.001124382,0.014678955,0.025405884,-0.0033226013,-0.01789856,-0.040863037,0.01411438,-0.0231781,0.02368164,-0.003604889,-0.011795044,0.01979065,-0.034423828,0.046722412,0.023101807,-0.01739502,0.06896973,0.012336731,-0.03616333,-0.010856628,-0.023803711,0.03805542,0.03012085,-0.0021381378,0.015625,0.016433716,0.010406494,0.005558014,-0.0000014901161,-0.009277344,0.05227661,-0.016647339,0.0046806335,-0.004497528,0.021575928,-0.0023994446,0.005542755,0.01398468,0.00598526,0.006198883,-0.0023860931,-0.021240234,0.0107421875,0.032287598,0.0024719238,0.0031490326,0.008880615,-0.011932373,-0.011512756,0.03152466,-0.016403198,-0.020019531,0.003189087,0.035858154,-0.020812988,0.018920898,0.020050049,-0.023757935,-0.0031394958,-0.017913818,0.00039434433,0.0019893646,0.016021729,0.019119263,0.011352539,-0.011428833,-0.0019159317,0.007671356,0.012771606,-0.010536194,0.022125244,0.02178955,0.016143799,0.003419876,0.009506226,-0.04574585,-0.00233078,0.011100769,-0.0075683594,-0.0021781921,-0.012756348,-0.025619507,0.0034103394,-0.01676941,-0.017044067,0.005268097,0.013420105,0.0146484375,0.0059814453,0.028945923,0.012268066,-0.00944519,-0.00869751,0.038482666,0.0013504028,-0.0143966675,0.0023670197,0.029403687,0.026748657,0.02571106,-0.015174866,0.031311035,-0.01826477,-0.00484848,-0.034088135,0.0012140274,-0.024307251,0.0061569214,-0.009292603,-0.000223279,-0.0077209473,0.005207062,-0.013252258,-0.011077881,0.03845215,-0.014175415,0.014511108,0.0035324097,-0.0016889572,0.030715942,0.0013132095,-0.005680084,-0.015289307,0.016281128,-0.042053223,-0.010101318,0.0066070557,-0.009635925,0.023086548,-0.009246826,0.008033752,0.032196045,0.016677856,0.008590698,-0.014907837,0.0010595322,0.047973633,0.00026798248,-0.024810791,0.026107788,0.016906738,-0.0046195984,0.02003479,-0.008506775,-0.019744873,0.028411865,0.021942139,-0.009353638,0.027053833,-0.012260437,0.0026874542,0.032928467,0.0067825317,-0.0079956055,0.0064468384,0.0041046143,0.007736206,-0.0009613037,-0.0054244995,-0.00869751,0.018936157,0.025634766,-0.0003681183,-0.0026359558,0.005970001,-0.011795044,-0.040924072,0.005050659,-0.0013961792,0.02861023,0.011222839,-0.015899658,-0.0007157326,-0.0034999847,-0.01448822,0.02532959,0.020828247,-0.016448975,-0.05697632,-0.023483276,-0.028182983,-0.009429932,0.00089502335,0.00086069107,0.040924072,0.051208496,0.0234375,-0.0076904297,-0.008598328,0.008506775,0.015945435,0.014625549,-0.0022792816,0.018508911,-0.015380859,-0.026611328,0.0072669983,-0.012535095,0.020141602,-0.052093506,0.010307312,-0.0059661865,0.0067634583,-0.0039863586,0.021270752,0.014717102,0.024932861,-0.035705566,-0.015319824,0.004547119,0.052520752,0.031433105,0.019332886,-0.023544312,0.016143799,-0.00969696,0.010643005,0.022918701,0.0020141602,0.020584106,-0.0055236816,0.029922485,0.0076522827,-0.012496948,-0.0016860962,0.012275696,-0.012863159,0.013870239,0.019927979,-0.017333984,-0.008270264,-0.030914307,-0.034301758,0.034240723,0.0014286041,0.007835388,0.0016269684,0.006225586,-0.008918762,-0.005970001,-0.019485474,0.013694763,-0.017105103,0.016586304,-0.020202637,0.038391113,-0.022109985,-0.030563354,0.0138168335,0.004558563,-0.010986328,-0.040374756,0.02609253,-0.020050049,0.029327393,-0.007282257,0.0036697388,-0.0005207062,0.026763916,0.011383057,-0.017974854,-0.037384033,0.028121948,-0.006717682,-0.029556274,-0.011672974,0.0010652542,0.028762817,0.0034713745,0.011634827,-0.023910522,0.012428284,0.023284912,0.024353027,0.024963379,0.02017212,-0.003124237,-0.009857178,0.0054893494,0.0057029724,-0.020843506,0.03338623,-0.014793396,0.011024475,-0.013549805,-0.011230469,0.01763916,-0.008552551,0.009742737,-0.0022964478,0.009590149,0.018447876,0.0126571655,0.00026392937,0.023803711,-0.003704071,0.033599854,-0.0035476685,0.0024471283,0.017471313,-0.021697998,-0.013641357,-0.0005187988,0.008781433,0.042236328,0.016052246,0.008308411,0.005039215,-0.0118637085,0.010864258,-0.0031032562,0.0050811768,0.019485474,-0.035827637,0.029708862,-0.0015115738,-0.04458618,-0.0036125183,-0.013870239,0.0055885315,-0.0009174347,-0.0019302368,0.013702393,0.022262573,0.0093307495,0.006614685,-0.0146865845,0.007003784,-0.01626587,-0.018432617,0.026535034,0.006576538,-0.0022602081,0.009506226,-0.008087158,0.005744934,0.02116394,-0.0015916824,0.034851074,-0.009376526,0.01689148,0.022079468,0.0032310486,0.020050049,0.013664246,-0.013015747,0.0067100525,-0.0016489029,-0.0007414818,0.017059326,-0.00349617,0.02784729,0.05984497,0.00073957443,0.05532837,-0.051605225,-0.017990112,0.0010499954,-0.006011963,-0.027938843,0.008659363,0.009544373,0.0068969727,-0.008232117,-0.02909851,0.021499634,0.023925781,0.06555176,-0.0073242188,-0.019256592,-0.028381348,0.01965332,0.010650635,0.013137817,-0.040893555,-0.015022278,0.014289856,0.011138916,-0.0011043549,0.005290985,-0.034362793,0.016647339,0.015899658,-0.04296875,-0.048187256,0.017944336,0.017623901,-0.0035915375,-0.00064086914,-0.023880005,0.014472961,-0.006011963,-0.0075187683,-0.00022053719,0.0034294128,-0.007499695,0.037353516,0.036743164,0.027069092,-0.0042533875,0.0038204193,-0.0015773773,-0.016525269,0.005420685,-0.02758789],"createdAt":"2026-04-18T19:59:16.171Z","updatedAt":"2026-04-22T02:45:05.535Z","lastSeenAt":"2026-04-22T02:45:05.535Z","tsv":"'0.05':174 '5':186 '50':182 'Nansen TGM perp positions' 'accept':128 'across':124 'address':164 'analyt':14,29,49,123 'api':15,30,194 'blockchain':13,28,48 'bodi':135 'btc':141 'call':176 'chain':126 'comprehens':119 'contract':36 'credit':183,187 'current':34 'derivatives positions' 'detail':53 'e.g':140 'endpoint':32,106 'enforc':199 'entri':59,99 'eth':142 'figur':84 'filter':76,92,149 'free':184 'futures positions' 'god':113 'header':210 'hyperliquid':9,24,43 'hyperliquid positions' 'hyperliquid-data' 'includ':58,156 'json':134 'key':195 'label':78,146,165 'level':122 'leverag':63 'leverage-tracking' 'limit':197 'liquid':66 'liquidation-price' 'list':159 'long/short':96 'mark':61 'metric':57 'minut':206 'mode':114 'money':81 'multipl':125 'nansen':11,26,46,110,167,193 'offer':118 'open':2,17 'open interest by address' 'option':145 'order':151 'pagin':148,158 'pagination' 'paramet':153 'part':108 'per':55,175,201,205 'per-minut':204 'per-posit':54 'per-second':200 'perp positions' 'perp-positions' 'perpetu':3,18,35 'perpetual positions' 'platform':50 'pnl':65,102 'pnl-tracking' 'posit':4,19,37,56,69,94,97,161 'post':130 'price':60,62,67,100,172 'pro':188 'profil':170 'protocol':180 'provid':52 'public':83 'rate':196 'record':162 'refin':90 'report':207 'request':131 'respons':155,209 'result':73 'retriev':1,16 'return':33 'second':202 'side':95 'smart':80 'smart-money-filtering' 'sol':143 'sorting' 'sourc':44 'specif':40 'specifi':136 'suit':116 'symbol':139 'system':171 'tgm':115 'tier':185,189 'token':7,22,41,112,121,138 'token-god-mode' 'token-level':120 'trader':87 'type':79,147 'unreal':64,101 'usd':72 'use':191 'valu':70,98 'via':10,25,177,208 'wallet':169 'wallet-labeling' 'whale':82 'x402':179","prices":[{"id":"3cf448d4-ac17-464b-91bf-34d59955d1c8","listingId":"5199fe1f-a1bb-4874-80d4-c4899e8ad33b","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":"Open perp positions for a token"},"asset_contract":"0x20c000000000000000000000b9537d11c60e8b50"},"createdAt":"2026-04-18T19:59:16.171Z"}],"sources":[{"listingId":"5199fe1f-a1bb-4874-80d4-c4899e8ad33b","source":"mpp_dev","sourceId":"nansen:POST:/api/v1/tgm/perp-positions","sourceUrl":"https://mpp.dev/api/services","isPrimary":true,"firstSeenAt":"2026-04-18T19:59:16.171Z","lastSeenAt":"2026-04-22T02:45:05.535Z"}],"details":{"listingId":"5199fe1f-a1bb-4874-80d4-c4899e8ad33b","quickStartSnippet":"curl -X POST https://api.nansen.ai/api/v1/tgm/perp-positions \\\n  -H 'Content-Type: application/json' \\\n  -H 'apiKey: YOUR_API_KEY' \\\n  -d '{\"token_symbol\": \"BTC\", \"label_type\": \"all_traders\", \"pagination\": {\"page\": 1, \"per_page\": 10}}'","exampleRequest":{"filters":{"side":["Long"],"position_value_usd":{"min":10000}},"order_by":[{"field":"position_value_usd","direction":"DESC"}],"label_type":"smart_money","pagination":{"page":1,"per_page":5},"token_symbol":"BTC"},"exampleResponse":{"data":[{"side":"Long","address":"0xa312114b5795dff9b8db50474dd57701aa78ad1e","leverage":"10X","upnl_usd":2515.52,"mark_price":102512.415,"entry_price":100500,"funding_usd":-45.23,"address_label":"Smart HL Perps Trader [0xa312]","leverage_type":"cross","position_size":"1.25","liquidation_price":91000,"position_value_usd":"128140.51875"}],"pagination":{"page":1,"per_page":5,"is_last_page":false}},"schema":{"path":"/api/v1/tgm/perp-positions","method":"POST","payment":{"amount":"50000","intent":"charge","method":"tempo","currency":"0x20c000000000000000000000b9537d11c60e8b50","decimals":6,"description":"Open perp positions for a token"},"description":"Open perp positions for a token"},"openapiUrl":null,"agentsTxtUrl":null,"citations":[{"claim":"Endpoint returns current perpetual positions for a specific token on Hyperliquid with entry price, mark price, leverage, PnL, and liquidation price.","source_url":"https://api.nansen.ai"},{"claim":"Pricing is $0.05 per call via x402 protocol, or 50 credits (free) / 5 credits (pro) via API key.","source_url":"https://api.nansen.ai"},{"claim":"Supports label_type filtering: smart_money, all_traders, whale, public_figure.","source_url":"https://api.nansen.ai"},{"claim":"Endpoint is live and returned HTTP 402 on HEAD probe (MPP challenge).","source_url":"https://api.nansen.ai/api/v1/tgm/perp-positions"}],"useCases":["Monitor which smart money wallets hold large perpetual positions on a given token","Identify highly leveraged positions approaching liquidation for a specific asset","Analyze long/short positioning sentiment across labeled trader cohorts","Build dashboards showing real-time perp position distribution by wallet label","Screen for whale perpetual positions on Hyperliquid tokens"],"bestFor":["Crypto traders analyzing smart money perpetual positioning on Hyperliquid","Quantitative researchers studying leverage and liquidation risk by trader cohort","DeFi analytics dashboards needing per-address perp position data","Agents that need structured on-chain derivatives position intelligence"],"notFor":["Spot token balance or holder queries (use TGM holders endpoint instead)","Historical position snapshots over time (this returns current positions only)","Non-Hyperliquid perpetual exchanges"],"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.535Z"}}