{"id":"f612e595-7a69-462a-9ea0-d0de9421d514","shortId":"PaAEYT","kind":"mpp","title":"Retrieve Hyperliquid perpetual positions, leverage, PnL, and account health for any wallet address.","tagline":"Retrieve Hyperliquid perpetual positions, leverage, PnL, and account health for any wallet address.","description":"This endpoint returns real-time perpetual position data for a given Hyperliquid wallet address by querying the Hyperliquid API through Nansen's profiler. It provides detailed position-level information including entry price, mark price, unrealized PnL, leverage (type and value), liquidation price, margin used, and return on equity for each open position. Account-level summaries are also included: cross margin account value, total margin used, total net liquidation position, and withdrawable balance.\n\nThe endpoint is part of Nansen's broader Profiler API suite, which covers wallet balances, transactions, PnL, counterparties, labels, and related wallets across 25+ chains. This specific endpoint focuses exclusively on Hyperliquid perpetual contracts. It accepts a 42-character hex address and supports optional filters on token symbol, position value, position type, and unrealized PnL, as well as custom sort ordering.\n\nPricing is $0.01 per call via the x402 protocol, or 10 credits (free tier) / 1 credit (pro tier) when using a Nansen API key. Rate limits are enforced per-second and per-minute, reported in response headers. The endpoint returns HTTP 402 for unauthenticated callers, which is the standard MPP/x402 payment challenge indicating the endpoint is live and ready to accept payment.","tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market"],"capabilities":["perp-positions","hyperliquid","wallet-profiling","leverage-data","liquidation-price","unrealized-pnl","margin-summary","account-health","multi-position","cross-margin","x402-payment"],"categories":["blockchain-analytics","defi"],"synonyms":["hyperliquid positions","perpetual futures positions","wallet perp data","leverage positions","liquidation risk","margin account","nansen profiler","perp portfolio","derivatives positions"],"warnings":["No standalone documentation pages were reachable (api.nansen.ai/docs returned 404); all information is derived from the OpenAPI spec.","Response schema uses $ref to PerpPositionsResponse/PerpPositionsData which are fully defined in components but the exact field names in a live response may vary slightly from the schema examples."],"endpointUrl":"https://api.nansen.ai/api/v1/profiler/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 pricing ($0.01/call via x402), and a live 402 MPP challenge confirming the endpoint is operational. Response schema references are well-documented with examples. Minor deduction because the crawled docs pages returned 404s (no standalone documentation site), so usage details come entirely from the OpenAPI spec.","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:49:03.506Z","embedding":[-0.04562378,0.006286621,0.058685303,0.0025310516,-0.0007381439,-0.026947021,-0.039123535,0.04827881,0.06124878,-0.01386261,0.028274536,0.0040130615,-0.0070762634,-0.042236328,0.01966858,0.047088623,-0.015792847,0.021469116,-0.05606079,0.07006836,0.025161743,-0.024414062,-0.027877808,0.020568848,-0.0061798096,-0.04006958,0.010917664,-0.01586914,0.0069236755,-0.046936035,0.08441162,-0.03338623,0.024642944,0.022613525,0.033355713,-0.006401062,0.019088745,0.03463745,-0.01133728,0.019119263,-0.01928711,-0.014701843,0.009796143,0.0010061264,-0.010871887,0.03616333,-0.034362793,-0.013023376,0.02670288,0.03540039,-0.035491943,0.0037059784,0.004131317,0.07495117,0.016357422,0.0019168854,0.031051636,0.007827759,0.007858276,-0.0050582886,0.009712219,-0.06793213,0.036193848,-0.024429321,-0.020507812,0.0062789917,-0.0077705383,0.04748535,-0.019088745,0.067871094,0.04425049,0.029678345,-0.011528015,-0.014884949,-0.039245605,0.00023245811,-0.016860962,0.015434265,-0.038238525,-0.01789856,-0.050201416,0.00793457,-0.04031372,-0.028198242,-0.0050735474,-0.025299072,-0.017868042,-0.0256958,-0.023773193,0.025924683,-0.03918457,-0.024291992,0.0030918121,-0.018295288,-0.012275696,-0.014274597,0.023788452,0.013313293,-0.00046753883,0.009727478,0.00242424,0.029342651,-0.005756378,-0.052246094,0.013038635,0.07562256,-0.0052871704,-0.0005326271,0.0064926147,0.017547607,-0.05154419,0.0004761219,-0.0048980713,-0.0077552795,0.0012874603,0.0423584,-0.041534424,0.008003235,-0.0029773712,-0.00415802,-0.0206604,0.018447876,0.08355713,-0.02067566,-0.025894165,-0.041870117,-0.004535675,-0.010147095,0.012428284,0.017059326,-0.01474762,0.022567749,0.0015563965,-0.020126343,-0.021774292,0.02796936,0.010803223,-0.034179688,0.008728027,-0.035491943,0.031982422,-0.020080566,0.029251099,-0.0023288727,-0.07537842,0.005760193,-0.010627747,-0.0068130493,-0.012077332,0.01512146,-0.00046372414,-0.038208008,-0.036315918,-0.014915466,-0.0102005005,-0.016464233,0.036743164,0.045776367,-0.038085938,0.0050201416,-0.061157227,0.07922363,0.0116119385,0.02029419,0.0034713745,0.02909851,-0.019042969,-0.03677368,-0.05606079,-0.019622803,-0.016494751,-0.011306763,0.006855011,-0.062408447,-0.0112838745,-0.040740967,0.0019664764,0.030822754,-0.007041931,-0.0045394897,-0.008125305,0.0019931793,0.053649902,-0.04800415,-0.03643799,0.002664566,-0.02381897,0.052490234,0.027801514,0.05303955,0.006919861,0.044067383,0.055358887,0.02670288,-0.04043579,0.0062217712,0.022979736,0.0018844604,-0.011978149,-0.012763977,0.00945282,-0.02279663,0.05255127,0.025924683,-0.0046081543,0.038238525,-0.005508423,-0.027526855,0.02217102,0.019165039,0.04699707,0.057037354,-0.0137786865,0.0079574585,-0.03086853,-0.00687027,-0.011207581,0.04626465,0.013427734,-0.0008993149,-0.027648926,0.012016296,-0.011489868,-0.0047187805,-0.06652832,0.03878784,0.066101074,-0.032287598,0.028671265,-0.040863037,0.012306213,0.03793335,-0.023468018,-0.044158936,0.02243042,-0.013511658,-0.0385437,-0.008766174,0.0034713745,-0.016784668,0.00003117323,0.0064430237,-0.033569336,0.008201599,0.061950684,-0.009422302,-0.029022217,-0.070495605,0.057159424,0.002729416,-0.022781372,-0.016693115,-0.011146545,-0.01864624,-0.021530151,-0.024871826,-0.006061554,0.0132751465,-0.0077705383,-0.053497314,0.042663574,0.012260437,-0.030807495,0.008583069,-0.0062828064,-0.004512787,-0.0047416687,0.027023315,-0.080566406,0.017745972,0.005077362,0.026000977,-0.004714966,-0.009590149,-0.07092285,0.024475098,0.02658081,-0.041015625,-0.021743774,0.033966064,-0.015472412,0.000834465,-0.0022640228,0.011054993,0.0060653687,0.013572693,0.015899658,0.02607727,0.0067443848,-0.014427185,0.009902954,-0.012321472,0.061950684,-0.022232056,0.040039062,-0.006160736,0.05404663,-0.02178955,0.014297485,-0.0099105835,-0.009613037,0.031433105,-0.013702393,-0.105285645,0.028198242,-0.0012960434,0.0128479,0.00040769577,-0.024887085,-0.021728516,-0.051239014,0.07092285,0.009849548,-0.012306213,-0.006881714,-0.012428284,0.031463623,-0.0018892288,-0.029571533,-0.035888672,0.02658081,-0.054138184,0.006126404,-0.045043945,0.0078125,0.01600647,0.0018815994,-0.040802002,0.0151901245,0.0061149597,0.04928589,-0.011726379,0.00504303,-0.026550293,0.007896423,-0.016067505,0.01007843,-0.020019531,0.02368164,-0.0066108704,0.011169434,-0.046539307,0.01689148,-0.032287598,0.025360107,0.012130737,0.019256592,0.017089844,0.010665894,-0.016677856,-0.058288574,0.01600647,0.017532349,0.026901245,0.037384033,0.0047798157,0.0035533905,-0.043670654,-0.054534912,-0.006164551,-0.061553955,-0.02760315,0.010108948,0.00472641,0.048217773,-0.017181396,-0.038879395,-0.04815674,0.010322571,-0.05105591,0.03591919,0.023880005,0.052856445,0.02607727,-0.008590698,0.013587952,-0.0012750626,0.013710022,-0.015960693,-0.022918701,0.04852295,0.01826477,0.00008785725,0.035247803,-0.0126571655,0.0068359375,-0.02671814,-0.0017719269,-0.04598999,-0.009262085,0.05078125,-0.008857727,-0.027069092,-0.039611816,0.005306244,-0.005809784,0.04345703,0.048614502,0.0033473969,-0.002111435,-0.03326416,0.01966858,-0.030593872,-0.023498535,-0.01965332,-0.031143188,0.0109939575,0.030654907,0.038391113,-0.008399963,0.017669678,0.002954483,0.0028858185,0.028503418,0.035095215,-0.018127441,0.018844604,-0.014846802,0.024765015,0.016448975,0.03137207,-0.057800293,0.038726807,0.01550293,-0.054107666,-0.02960205,0.04055786,-0.016601562,-0.02116394,-0.07531738,-0.02835083,0.023269653,0.03933716,-0.015701294,-0.025878906,0.0005426407,-0.016677856,0.036254883,-0.02166748,0.038024902,-0.012123108,-0.019332886,-0.053710938,-0.024963379,-0.038085938,0.011253357,0.018615723,-0.027618408,0.00034809113,-0.022109985,0.0009279251,0.009895325,0.04232788,-0.014884949,0.018127441,-0.02381897,0.032196045,-0.023605347,0.034820557,-0.003293991,-0.03503418,0.014625549,0.017456055,0.0137786865,0.004764557,-0.0015563965,-0.01966858,0.006706238,-0.03186035,0.002319336,0.020767212,-0.027648926,0.03289795,-0.004623413,-0.029174805,0.004219055,-0.036132812,0.023284912,-0.016479492,0.0039138794,-0.020614624,-0.052001953,-0.09857178,-0.020431519,0.031280518,0.071777344,0.029449463,0.004016876,-0.058563232,-0.026504517,0.025390625,-0.0025596619,0.051361084,-0.013336182,-0.033813477,-0.007820129,0.005695343,-0.04309082,0.042236328,-0.008033752,0.015426636,-0.038391113,0.035125732,0.038024902,0.061645508,0.0066184998,-0.0052452087,-0.015052795,-0.02331543,0.07409668,-0.026168823,0.049987793,-0.035980225,-0.004760742,-0.041778564,-0.010246277,-0.017456055,0.030456543,-0.00012886524,-0.0034656525,0.034851074,0.016143799,0.006099701,-0.019500732,0.017623901,-0.012313843,-0.04333496,-0.04714966,0.041931152,-0.01991272,0.032470703,-0.0012893677,-0.004436493,0.041137695,-0.058654785,0.0064048767,-0.002418518,-0.024856567,-0.029800415,-0.0062217712,-0.015487671,-0.009475708,-0.031677246,-0.0021743774,0.033081055,-0.00040006638,0.07067871,-0.00040197372,0.009346008,0.0058898926,-0.014587402,-0.021255493,0.025268555,0.010574341,-0.00004416704,0.024719238,-0.0096206665,-0.046844482,0.045410156,0.000893116,0.02835083,-0.00039219856,0.019165039,0.013290405,-0.009803772,-0.0064697266,0.027053833,-0.021377563,-0.015609741,0.019226074,0.0074691772,-0.017807007,0.008491516,-0.045043945,0.064453125,0.021148682,-0.03186035,-0.0029296875,0.03894043,0.018218994,-0.020217896,0.0024681091,-0.0064048767,0.027801514,-0.016693115,0.05279541,-0.010749817,0.029067993,-0.01612854,0.031311035,0.005680084,-0.009277344,0.016799927,0.007965088,-0.037139893,-0.013038635,0.035736084,-0.00038909912,0.018188477,-0.047454834,0.015487671,0.016098022,-0.030975342,0.007511139,-0.030349731,0.006626129,0.03225708,0.019622803,-0.008018494,-0.0064888,-0.043792725,0.01574707,-0.02835083,0.026000977,-0.00011855364,0.047546387,-0.0023536682,0.024383545,0.010749817,-0.00070619583,0.019363403,-0.02607727,-0.0011100769,0.03326416,0.024780273,-0.023544312,-0.04800415,-0.04360962,-0.03463745,0.018569946,0.0035743713,-0.024215698,0.01361084,-0.013572693,0.010734558,0.007858276,-0.012321472,0.04345703,-0.0116119385,-0.05935669,-0.0027256012,0.02255249,0.005607605,-0.0033569336,0.0066986084,-0.008552551,-0.01966858,-0.012374878,-0.01423645,-0.01977539,-0.004787445,-0.029144287,0.029907227,-0.014160156,-0.00983429,-0.018066406,-0.031799316,-0.0088272095,-0.021942139,0.030731201,-0.039520264,0.01928711,0.0008330345,0.011871338,-0.041015625,0.0052108765,0.014709473,0.017684937,0.008552551,-0.005470276,-0.017944336,0.054656982,0.03237915,0.005207062,-0.019622803,-0.024139404,0.021011353,-0.028518677,-0.005908966,0.00819397,0.012809753,0.002155304,-0.013374329,-0.02128601,0.0009212494,-0.010009766,0.0181427,-0.005317688,0.05279541,0.0018138885,-0.0032806396,0.0070114136,0.0038585663,-0.038635254,0.017044067,-0.027328491,0.010101318,0.016143799,0.028244019,0.0022411346,-0.013809204,-0.027053833,-0.022994995,-0.07324219,-0.0044937134,-0.020858765,-0.0019664764,0.026977539,0.010047913,-0.0021076202,-0.05621338,0.033233643,-0.017715454,-0.019714355,-0.022964478,0.019378662,-0.006095886,-0.042785645,0.018676758,0.0015354156,0.005973816,0.016860962,0.01777649,0.00894928,0.02796936,0.007896423,0.038726807,0.035705566,0.03173828,-0.03274536,-0.004119873,-0.02784729,-0.062438965,-0.022644043,-0.0006580353,-0.02192688,-0.0069732666,-0.005844116,-0.01586914,-0.0019454956,-0.016357422,-0.036865234,0.012825012,-0.000213027,0.02293396,-0.008590698,0.00045466423,0.0017623901,0.020446777,0.0013389587,-0.03152466,0.009017944,0.008453369,0.031951904,0.0079956055,-0.04071045,-0.015426636,-0.02067566,0.020065308,-0.019638062,-0.00315094,0.008056641,0.008895874,0.024841309,0.0135269165,0.005569458,-0.018875122,0.019317627,0.011772156,-0.041748047,0.0076179504,-0.00026488304,0.013412476,0.033569336,0.047210693,-0.072753906,0.012924194,0.0018339157,0.005832672,-0.013412476,0.0024852753,-0.020492554,0.048675537,-0.025268555,-0.00080156326,-0.018753052,-0.0033912659,-0.015449524,-0.031280518,-0.010559082,-0.04977417,-0.03363037,0.01109314,-0.03479004,0.011329651,0.046020508,-0.017608643,-0.060699463,0.0032310486,0.021240234,-0.03656006,0.011604309,-0.010513306,-0.020446777,0.014175415,-0.008903503,-0.021377563,0.07006836,-0.03466797,0.020080566,-0.016479492,0.029754639,0.027420044,0.039154053,0.020263672,0.013137817,-0.030731201,-0.030197144,-0.0027389526,-0.018218994,0.014503479,-0.01701355,0.023971558,-0.011711121,0.013450623,0.041900635,-0.040740967,0.019958496,0.023330688,0.014297485,-0.007156372,0.015274048,0.0032806396,-0.005256653,-0.012527466,-0.010971069,-0.017105103,0.015655518,-0.01586914,0.024414062,0.028305054,0.012084961,-0.002073288,-0.020248413,0.015365601,0.01550293,0.004096985,0.013389587,0.0058288574,0.031677246,-0.0013427734,0.019317627,0.028198242,0.010871887,0.00957489,-0.04147339,-0.0052719116,-0.009140015,0.009429932,-0.011741638,0.00012052059,-0.023742676,0.021911621,-0.009437561,0.0046577454,0.021911621,0.015792847,-0.00083351135,0.013801575,-0.011169434,0.0104522705,0.038238525,-0.0042419434,0.04067993,-0.020690918,0.013000488,-0.017044067,-0.006668091,0.017456055,0.01512146,-0.011238098,-0.0057907104,0.00831604,-0.010421753,0.0087509155,-0.001039505,-0.04043579,0.009284973,-0.017608643,0.0076560974,0.00055360794,0.028152466,-0.034484863,-0.01838684,0.015945435,-0.001666069,-0.018920898,0.05014038,-0.0019044876,0.018371582,0.03793335,0.012573242,-0.00049877167,0.0034561157,0.021057129,-0.026855469,0.017333984,-0.004486084,0.013748169,0.0034217834,0.045776367,0.014709473,0.009132385,0.003129959,0.022949219,0.0070381165,-0.021118164,0.0060272217,-0.01625061,-0.020568848,0.037322998,-0.000013291836,-0.023330688,-0.00054359436,0.013977051,-0.015945435,0.008041382,-0.064208984,0.039611816,-0.0064811707,-0.023971558,0.0146865845,0.010391235,0.01826477,0.004737854,0.030578613,0.01525116,-0.030181885,0.032073975,0.03845215,0.0069389343,0.00617218,0.039245605,-0.004673004,0.0178833,0.0029067993,0.0075950623,-0.014762878,0.015541077,-0.040893555,-0.006122589,-0.038909912,0.010246277,-0.024291992,0.00012022257,-0.004634857,0.04043579,0.017318726,0.05331421,-0.015792847,0.02154541,0.011291504,-0.031921387,-0.066101074,0.022491455,-0.01852417,0.0158844,0.014671326,0.0037841797,0.016677856,-0.0016736984,0.016647339,0.015434265,0.052337646,0.0501709,0.01638794,0.0077323914,0.012199402,0.025100708,0.03942871,-0.0017938614,0.05444336,-0.004711151,-0.0033493042,-0.002708435,0.032073975,-0.020492554,0.010047913,0.051696777,0.01687622,0.010978699,0.06549072,0.0013093948,-0.02609253,0.020721436,-0.039978027,0.019042969,0.015235901,0.024627686,0.01411438,0.0055236816,0.02381897,0.005962372,-0.035339355,-0.030227661,0.031311035,0.08001709,-0.007095337,0.004951477,-0.018661499,0.035247803,-0.049438477,-0.049194336,0.00016617775,-0.0029354095,0.015136719,-0.013900757,0.019058228,-0.007843018,-0.0009937286,-0.009819031,-0.010009766,-0.030548096,0.007873535,0.034179688,-0.0053901672,0.023605347,-0.031463623,-0.0073623657,0.008583069,0.0069999695,0.009819031,0.008735657,0.024032593,-0.01058197,-0.01727295,-0.015151978,0.03668213,0.022659302,0.008071899,-0.0053138733,0.028305054,-0.00045514107,-0.031173706,0.031097412,0.007896423,0.0066986084,0.015075684,0.022567749,0.018707275,-0.008010864,0.012619019,0.025146484,0.012290955,0.0031490326,0.027420044,-0.011390686,-0.027450562,0.051239014,0.0060768127,0.00242424,0.013664246,-0.0042381287,-0.008285522,0.0007882118,0.051605225,0.030899048,-0.0068740845,-0.036499023,-0.021362305,0.005302429,0.013450623,-0.009376526,0.021606445,-0.0036125183,0.012123108,0.033477783,-0.009796143,0.041137695,0.01134491,-0.0105896,0.004535675,-0.005252838,-0.0181427,0.0007100105,0.0513916,0.0085372925,0.01663208,0.034423828,0.00497818,-0.00957489,-0.021606445,-0.004055023,0.023742676,0.018569946,-0.019042969,-0.00806427,0.025268555,0.02029419,0.000051796436,-0.0063438416,0.017211914,-0.0061950684,0.0011129379,-0.020904541,-0.0053215027,0.015052795,-0.0090789795,0.0053138733,0.0032024384,0.03829956,0.0105896,0.04888916,0.0020370483,-0.03062439,-0.008178711,0.02909851,-0.01411438,0.009292603,0.011482239,-0.013648987,0.0001540184,0.0181427,0.042297363,-0.0052452087,0.019454956,0.014038086,0.010299683,0.011062622,-0.025970459,0.0051078796,0.00083494186,-0.0037441254,0.014762878,-0.014312744,-0.014816284,-0.017501831,0.015014648,-0.017120361,0.035308838,-0.024276733,-0.0016832352,0.0062217712,-0.02835083,0.04156494,-0.0012254715,-0.031280518,0.062561035,0.012184143,-0.004722595,-0.006340027,-0.024505615,0.046844482,0.037231445,-0.0049476624,0.014976501,0.005050659,0.00015044212,0.039764404,0.011894226,0.011505127,0.062164307,-0.015274048,0.00071525574,0.008712769,0.0058517456,-0.003200531,0.0032844543,-0.002149582,0.0149383545,-0.002363205,-0.022506714,-0.011169434,-0.0036506653,0.03643799,0.02116394,0.005180359,0.013961792,-0.008766174,-0.002538681,0.010726929,-0.0116119385,0.001786232,0.018585205,0.029876709,-0.010482788,0.019073486,-0.0025234222,-0.013763428,-0.00819397,-0.01828003,0.0013084412,0.016220093,0.009765625,0.01890564,0.021957397,0.014099121,0.00050258636,0.023208618,0.0368042,-0.0076560974,0.031051636,0.025802612,0.028198242,0.015563965,-0.009048462,-0.0259552,-0.0041275024,0.031219482,-0.006462097,-0.0038337708,0.012512207,-0.014533997,0.007896423,0.023162842,-0.036743164,0.0018558502,0.015792847,0.013450623,-0.0034122467,0.02949524,0.009895325,0.007926941,-0.012680054,0.024124146,-0.002357483,-0.024093628,-0.006126404,0.024551392,0.03338623,0.02166748,-0.0028686523,0.013465881,-0.006454468,0.019256592,-0.028579712,0.006122589,-0.007041931,0.01159668,0.0012569427,-0.011680603,-0.010475159,0.01473999,-0.014434814,-0.00919342,0.028549194,-0.007827759,0.014312744,0.0071487427,0.008865356,0.018356323,-0.0037460327,-0.0056381226,-0.0041503906,0.023269653,-0.04269409,0.004436493,-0.0027694702,-0.010810852,0.015258789,-0.010528564,0.006767273,0.008972168,0.006980896,0.021255493,-0.0063934326,-0.0005803108,0.031402588,0.010635376,-0.024932861,0.013198853,-0.0036258698,0.012237549,0.027679443,-0.009490967,-0.03692627,0.021362305,0.007282257,0.003484726,0.034210205,-0.016647339,-0.0014038086,0.018875122,-0.017669678,-0.029556274,0.007335663,0.0056495667,-0.012321472,0.0076179504,-0.012359619,-0.0019664764,0.015838623,0.039489746,-0.008491516,-0.006450653,0.0059509277,0.0075263977,-0.033172607,0.020980835,-0.00869751,0.028244019,0.02255249,-0.0050964355,-0.020874023,0.00919342,-0.00076436996,0.011009216,0.019180298,-0.029922485,-0.05895996,-0.014137268,-0.016708374,0.009269714,0.0016593933,-0.0093307495,0.040252686,0.03616333,-0.012016296,-0.0112838745,-0.003479004,0.004322052,0.015563965,0.0026836395,-0.0066070557,0.014160156,-0.029693604,-0.04348755,0.0077705383,-0.021255493,0.026397705,-0.045684814,0.01940918,-0.01651001,-0.004711151,0.0005426407,0.024490356,0.007461548,0.026229858,-0.042388916,-0.0016450882,0.012710571,0.046844482,0.032989502,-0.0113220215,0.0046081543,0.008728027,-0.004219055,0.018356323,0.015899658,0.0060272217,0.030426025,-0.025482178,0.020080566,-0.01360321,-0.027328491,0.000477314,0.006198883,-0.027420044,0.009239197,0.0067863464,-0.015960693,0.013549805,-0.016311646,-0.042510986,0.019958496,-0.007545471,0.0004234314,0.0019483566,0.0005941391,-0.01184082,-0.0118255615,0.0027618408,0.021911621,0.008010864,-0.00023412704,-0.024353027,0.022903442,-0.009422302,-0.025482178,0.002292633,-0.011779785,-0.030197144,-0.037200928,0.02218628,0.0010290146,0.014839172,0.017684937,0.018814087,-0.0058517456,0.031280518,0.0034503937,-0.021469116,-0.06201172,0.057800293,-0.0006518364,-0.011993408,0.0049057007,-0.0046844482,0.026672363,0.020492554,0.018157959,0.0057296753,-0.0024108887,0.016220093,-0.0005726814,0.00053215027,0.025421143,0.0008869171,-0.0017642975,0.003112793,0.01550293,0.002439499,0.015090942,-0.02670288,0.022094727,-0.021743774,-0.028625488,0.026992798,0.0039482117,0.011405945,0.010650635,0.009346008,0.023406982,-0.003452301,-0.02810669,0.01586914,-0.015426636,0.016113281,0.023468018,-0.0026435852,0.0134887695,-0.02784729,-0.0017185211,0.0056762695,0.00737381,0.030731201,0.00497818,0.002878189,-0.0025196075,-0.011146545,0.011047363,0.011192322,-0.0010509491,0.0030155182,-0.0287323,0.033081055,-0.008026123,-0.037902832,-0.010032654,-0.023666382,0.014160156,-0.003255844,0.0026779175,0.020019531,0.01096344,-0.0016841888,0.0024299622,-0.027404785,-0.021255493,-0.005420685,0.009109497,0.025802612,-0.016342163,0.008468628,0.0046920776,0.0027275085,0.020080566,0.026321411,0.010688782,0.04446411,0.01676941,0.034179688,0.035705566,0.013664246,0.027404785,0.004673004,-0.010177612,0.0034809113,-0.0067481995,0.011192322,0.008171082,-0.012748718,0.024368286,0.06628418,0.0018253326,0.06210327,-0.04269409,-0.028778076,-0.025817871,-0.012031555,-0.04626465,0.018295288,-0.0028572083,0.012664795,-0.0093688965,-0.020355225,0.002872467,0.0390625,0.06173706,-0.009590149,-0.010871887,-0.01209259,0.013839722,-0.00088119507,-0.0028934479,-0.03024292,0.013999939,-0.0016832352,0.00932312,-0.0058403015,0.004360199,-0.026306152,0.024032593,0.017242432,-0.048065186,-0.028945923,0.0112838745,0.018218994,-0.004840851,0.005683899,-0.018997192,0.010185242,0.004207611,-0.0030326843,-0.004386902,0.01763916,-0.03314209,0.017959595,0.011917114,0.021865845,-0.003358841,-0.0005226135,-0.0037899017,-0.045837402,-0.0016765594,-0.019927979],"createdAt":"2026-04-18T19:59:13.707Z","updatedAt":"2026-04-22T02:45:05.419Z","lastSeenAt":"2026-04-22T02:45:05.419Z","tsv":"'0.01':165 '1':177 '10':173 '25':125 '402':206 '42':139 'accept':137,225 'account':8,21,82,90 'account-health' 'account-level':81 'across':124 'address':13,26,41,142 'also':86 'api':46,111,185 'balanc':101,116 'broader':109 'call':167 'caller':209 'chain':126 'challeng':216 'charact':140 'contract':135 'counterparti':119 'cover':114 'credit':174,178 'cross':88 'cross-margin' 'custom':160 'data':35 'derivatives positions' 'detail':53 'endpoint':28,103,129,203,219 'enforc':190 'entri':59 'equiti':76 'exclus':131 'filter':146 'focus':130 'free':175 'given':38 'header':201 'health':9,22 'hex':141 'http':205 'hyperliquid':2,15,39,45,133 'hyperliquid positions' 'includ':58,87 'indic':217 'inform':57 'key':186 'label':120 'level':56,83 'leverag':5,18,65 'leverage positions' 'leverage-data' 'limit':188 'liquid':69,97 'liquidation risk' 'liquidation-price' 'live':221 'margin':71,89,93 'margin account' 'margin-summary' 'mark':61 'minut':197 'mpp/x402':214 'multi-position' 'nansen':48,107,184 'nansen profiler' 'net':96 'open':79 'option':145 'order':162 'part':105 'payment':215,226 'per':166,192,196 'per-minut':195 'per-second':191 'perp portfolio' 'perp-positions' 'perpetu':3,16,33,134 'perpetual futures positions' 'pnl':6,19,64,118,156 'posit':4,17,34,55,80,98,150,152 'position-level':54 'price':60,62,70,163 'pro':179 'profil':50,110 'protocol':171 'provid':52 'queri':43 'rate':187 'readi':223 'real':31 'real-tim':30 'relat':122 'report':198 'respons':200 'retriev':1,14 'return':29,74,204 'second':193 'sort':161 'specif':128 'standard':213 'suit':112 'summari':84 'support':144 'symbol':149 'tier':176,180 'time':32 'token':148 'total':92,95 'transact':117 'type':66,153 'unauthent':208 'unreal':63,155 'unrealized-pnl' 'use':72,94,182 'valu':68,91,151 'via':168 'wallet':12,25,40,115,123 'wallet perp data' 'wallet-profiling' 'well':158 'withdraw':100 'x402':170 'x402-payment'","prices":[{"id":"52d51f74-d787-424b-a7d1-13fea2d9adf7","listingId":"f612e595-7a69-462a-9ea0-d0de9421d514","amountUsd":"0.01","unit":"per_call","nativeCurrency":"pathUSD","nativeAmount":"10000","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":"10000","intent":"charge","method":"tempo","currency":"0x20c000000000000000000000b9537d11c60e8b50","decimals":6,"description":"Wallet perp positions and account health"},"asset_contract":"0x20c000000000000000000000b9537d11c60e8b50"},"createdAt":"2026-04-18T19:59:13.707Z"}],"sources":[{"listingId":"f612e595-7a69-462a-9ea0-d0de9421d514","source":"mpp_dev","sourceId":"nansen:POST:/api/v1/profiler/perp-positions","sourceUrl":"https://mpp.dev/api/services","isPrimary":true,"firstSeenAt":"2026-04-18T19:59:13.707Z","lastSeenAt":"2026-04-22T02:45:05.419Z"}],"details":{"listingId":"f612e595-7a69-462a-9ea0-d0de9421d514","quickStartSnippet":"curl -X POST https://api.nansen.ai/api/v1/profiler/perp-positions \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"address\": \"0xa312114b5795dff9b8db50474dd57701aa78ad1e\"}'","exampleRequest":{"address":"0xa312114b5795dff9b8db50474dd57701aa78ad1e","filters":{"position_value_usd":{"min":1000}},"order_by":[{"field":"position_value_usd","direction":"DESC"}]},"exampleResponse":{"data":{"time":1761283435707,"withdrawable":"2933647.2403759998","assetPositions":[{"position":{"size":"-90052.0","token_symbol":"MOODENG","leverage_type":"cross","leverage_value":5,"entry_price_usd":"0.311285","margin_used_usd":"2020.946984","return_on_equity":"3.1976362269","position_value_usd":"10104.73492","unrealized_pnl_usd":"17927.1615","liquidation_price_usd":"39.6872752647"},"position_type":"oneWay"}],"margin_summary_account_value_usd":"4643143.4382309997","margin_summary_total_margin_used_usd":"1456365.231985"}},"schema":{"path":"/api/v1/profiler/perp-positions","method":"POST","payment":{"amount":"10000","intent":"charge","method":"tempo","currency":"0x20c000000000000000000000b9537d11c60e8b50","decimals":6,"description":"Wallet perp positions and account health"},"description":"Wallet perp positions and account health"},"openapiUrl":null,"agentsTxtUrl":null,"citations":[{"claim":"Endpoint is POST /api/v1/profiler/perp-positions and returns perpetual positions from Hyperliquid API","source_url":"https://api.nansen.ai"},{"claim":"Pricing is $0.01 per call via x402 protocol, or 10 credits (free) / 1 credit (pro)","source_url":"https://api.nansen.ai"},{"claim":"Endpoint returned HTTP 402 on HEAD probe confirming it is live via MPP challenge","source_url":"https://api.nansen.ai/api/v1/profiler/perp-positions"},{"claim":"Request requires a 42-character hex address and supports filters on token_symbol, position_value_usd, position_type, unrealized_pnl_usd","source_url":"https://api.nansen.ai"},{"claim":"Response includes assetPositions array with entry_price, mark_price, leverage, liquidation_price, unrealized_pnl, plus account-level margin summaries","source_url":"https://api.nansen.ai"}],"useCases":["Monitor a trader's open Hyperliquid perpetual positions and unrealized PnL in real time","Assess liquidation risk by checking leverage levels and liquidation prices for a wallet","Build dashboards showing account health metrics (margin used, withdrawable balance, account value)","Track smart money perpetual positioning by querying known wallet addresses","Integrate perp position data into automated trading or risk management systems"],"bestFor":["Querying real-time Hyperliquid perpetual positions for a specific wallet","Assessing account-level margin health and liquidation risk","Agents or bots that need per-call pay-as-you-go blockchain analytics"],"notFor":["Historical perpetual position snapshots (use profiler/perp-trades or TGM endpoints instead)","Spot token balances or DeFi holdings (use profiler/address/current-balance or portfolio/defi-holdings)","Aggregated market-wide perp data (use TGM perp-positions or perp-screener endpoints)"],"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.419Z"}}