{"id":"18d3125b-fe0b-4761-bbda-a534354316dc","shortId":"yLQj8k","kind":"mpp","title":"Perpetual trading history for a token on Hyperliquid via Nansen's Token God Mode analytics","tagline":"Perpetual trading history for a token on Hyperliquid via Nansen's Token God Mode analytics","description":"This endpoint retrieves perpetual trade data for a specific token on Hyperliquid through Nansen's Token God Mode (TGM) suite. It returns individual trade records including trader address, trade side (Long/Short), action type (Add/Reduce/Open/Close), order type (Market/Limit), price, size, value in USD, and transaction hash. The data covers smart money and all traders on Hyperliquid perpetual contracts.\n\nThe endpoint accepts POST requests with a JSON body specifying the token symbol (e.g., \"BTC\", \"ETH\"), a date range, optional filters (by trader address, side, action, order type, smart money labels, price/value ranges), pagination, and sort order. Responses include paginated trade records with rate-limit and credit-usage headers. The endpoint costs $0.01 per call via x402 protocol, or 10 credits (free tier) / 1 credit (pro tier) with an API key.\n\nNansen's API is documented via OpenAPI 3.1.0 and supports authentication via API key or x402 pay-per-request. The perp trades endpoint is part of a broader suite covering smart money analytics, wallet profiling, token flows, prediction markets, and more across 25+ chains.","tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market"],"capabilities":["perpetual-trades","hyperliquid-perps","token-god-mode","smart-money-filtering","trade-history","long-short-positions","market-limit-orders","pagination","sorting","date-range-filtering"],"categories":["blockchain-analytics","defi","trading"],"synonyms":["perp trades","perpetual futures trades","hyperliquid trades","token perp history","derivatives trading data","nansen perp trades","TGM perp trades"],"warnings":["Probe returned 401 (Unauthorized) rather than 402 on HEAD/GET — the endpoint requires POST method and may need API key or x402 payment header to trigger the 402 challenge","No direct crawl of Nansen documentation site was available; all info derived from OpenAPI spec","Only Hyperliquid perpetual contracts are supported — no other perp exchanges"],"endpointUrl":"https://api.nansen.ai/api/v1/tgm/perp-trades","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.820","qualityRationale":"Full OpenAPI 3.1.0 schema with detailed endpoint description, request/response models, filters, sort fields, and pricing info. The probe returned 401 (not 402) so the MPP payment challenge was not confirmed, but the OpenAPI spec explicitly documents x402 support at $0.01/call. The origin root returns 200 with {\"message\":\"ok\"}, confirming the API is live.","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:50:38.415Z","embedding":[-0.040649414,0.009147644,0.03729248,-0.0066986084,0.011940002,-0.016723633,-0.06304932,0.03768921,0.05026245,-0.014854431,-0.0010023117,0.017105103,-0.027770996,-0.05267334,-0.00894928,0.021820068,-0.027053833,0.011634827,-0.047576904,0.05596924,0.019134521,0.00274086,-0.04537964,0.024536133,-0.04711914,-0.021057129,0.01335144,0.037628174,0.013137817,-0.042388916,0.052703857,-0.037750244,0.016921997,0.0023460388,0.03286743,0.0026721954,0.045959473,0.023956299,0.0052108765,-0.027145386,-0.020767212,-0.035858154,0.011405945,0.032836914,-0.021697998,0.021606445,-0.06506348,-0.0209198,0.0016756058,0.043121338,-0.03161621,-0.006061554,-0.030334473,0.046447754,0.043029785,-0.0070228577,-0.026901245,0.009399414,0.020629883,-0.00040078163,-0.028198242,-0.059387207,0.053253174,-0.017532349,-0.01939392,0.004638672,-0.032592773,0.048065186,-0.03050232,0.10345459,0.034729004,0.0057258606,-0.0040359497,-0.032043457,-0.030960083,0.014373779,-0.021331787,0.039245605,-0.011909485,-0.017730713,-0.009681702,-0.019805908,-0.0690918,-0.03656006,0.024353027,-0.024414062,-0.034942627,-0.037719727,-0.040649414,0.017074585,-0.03579712,-0.04208374,0.015914917,0.01878357,0.016036987,-0.017181396,0.022369385,0.00945282,0.019515991,0.033599854,0.0035552979,0.025527954,-0.009140015,-0.013420105,0.018463135,0.065979004,-0.02229309,-0.019210815,-0.0049705505,0.000541687,-0.06365967,-0.026992798,0.010269165,-0.010688782,0.026489258,0.02671814,-0.044281006,0.020019531,0.0049858093,-0.0007286072,-0.036468506,-0.02178955,0.093811035,-0.03527832,-0.030227661,-0.010437012,-0.041748047,-0.04827881,0.00844574,0.021224976,0.009262085,0.0019044876,-0.0015487671,-0.051239014,-0.031585693,-0.015411377,-0.024612427,-0.013031006,0.0022621155,-0.021728516,0.02494812,-0.020965576,0.01927185,0.011260986,-0.10418701,0.018585205,-0.025009155,-0.0006365776,-0.041229248,0.006088257,-0.011619568,-0.0362854,-0.03149414,-0.018844604,0.0036907196,-0.025985718,0.01789856,0.03778076,-0.05545044,-0.014373779,-0.07940674,0.06774902,-0.0013446808,0.0262146,0.0073623657,0.05407715,-0.002462387,-0.0635376,-0.06921387,-0.021759033,0.004966736,-0.015975952,-0.015182495,-0.029418945,-0.02670288,-0.025299072,-0.016403198,0.01889038,-0.023498535,-0.031280518,-0.026504517,-0.012535095,0.016708374,-0.04437256,-0.033935547,-0.00737381,-0.034362793,0.07476807,0.017044067,0.03552246,0.0041275024,0.05065918,0.07720947,0.021148682,-0.057159424,-0.032714844,0.009979248,0.009498596,0.034606934,0.009140015,0.046722412,-0.022445679,0.012306213,0.028182983,-0.018341064,0.0011014938,0.0077667236,-0.043029785,0.032073975,0.0010147095,0.05090332,0.046539307,-0.014884949,0.007133484,-0.02633667,-0.00077438354,-0.026351929,0.031707764,-0.009307861,0.030303955,-0.009361267,0.012207031,-0.0050697327,-0.0011339188,-0.041534424,0.046875,0.048950195,-0.031463623,-0.008079529,-0.0463562,-0.0017309189,0.057769775,-0.026977539,-0.034973145,0.02645874,-0.022445679,0.0002758503,-0.034118652,0.020233154,-0.04675293,-0.0025100708,0.008163452,-0.021697998,0.015434265,0.0017271042,-0.0011358261,-0.041046143,-0.07244873,0.048980713,0.02935791,-0.0023918152,-0.018508911,-0.041534424,-0.013458252,0.008506775,-0.035980225,0.0028629303,0.025390625,-0.045959473,-0.022537231,0.044677734,-0.01171875,-0.0015449524,-0.006336212,-0.023040771,0.007797241,-0.018341064,-0.011299133,-0.046173096,0.002910614,0.017166138,0.025985718,0.010795593,-0.039916992,-0.05545044,0.029388428,0.024749756,-0.018066406,-0.009780884,-0.0066490173,-0.009254456,0.011978149,0.01928711,0.019500732,0.002456665,0.0074539185,0.039215088,0.053985596,0.017532349,-0.03857422,-0.008651733,-0.0022125244,0.05822754,-0.021072388,0.035064697,0.029174805,0.04360962,-0.011367798,-0.008544922,-0.010658264,-0.011222839,0.015007019,-0.026565552,-0.08959961,-0.005695343,-0.002784729,0.015533447,-0.005844116,-0.008049011,-0.02116394,-0.022872925,0.040527344,-0.011062622,-0.0078048706,0.011833191,-0.0151901245,0.05609131,-0.013191223,-0.024765015,-0.039642334,0.004989624,-0.04269409,0.0056419373,0.010429382,0.008422852,-0.035095215,-0.014221191,-0.05493164,0.0039787292,0.0049362183,0.03866577,-0.0001462698,0.018341064,-0.022644043,-0.012908936,-0.005809784,0.011520386,-0.012565613,0.0119018555,-0.0044555664,0.008720398,-0.06402588,-0.014129639,-0.048431396,0.035308838,0.021575928,-0.006614685,0.013832092,0.00021338463,-0.01449585,-0.039001465,0.018569946,0.013175964,0.024932861,0.021194458,-0.029769897,-0.01701355,-0.046142578,-0.03894043,0.0009965897,-0.078186035,0.0022506714,0.0009241104,-0.007751465,0.06488037,-0.032806396,-0.027404785,-0.02532959,0.0070152283,-0.068603516,0.019454956,0.02973938,0.04385376,-0.0008635521,-0.02230835,0.02178955,0.019927979,0.018722534,0.005054474,0.0039901733,0.039916992,-0.030548096,0.018295288,0.018737793,-0.0016736984,0.015357971,-0.004760742,0.020690918,-0.050354004,-0.03086853,0.027023315,-0.032318115,-0.03314209,-0.0024204254,-0.0064468384,0.00018513203,0.02720642,0.036956787,-0.008468628,0.038391113,-0.006587982,0.026107788,-0.03488159,-0.040374756,0.004787445,-0.02911377,0.020965576,0.054779053,0.010215759,-0.004951477,0.020309448,0.019714355,0.0059394836,-0.014099121,0.025131226,0.0015392303,0.009284973,0.006500244,0.0026073456,-0.0022602081,0.031219482,-0.04269409,0.02671814,-0.014846802,-0.06854248,-0.018447876,0.04385376,-0.006088257,-0.0151901245,-0.045166016,-0.015853882,0.0065612793,0.03262329,-0.019943237,-0.039520264,0.0039138794,0.002418518,0.014846802,-0.02494812,0.036956787,-0.014320374,-0.01914978,-0.027557373,-0.009170532,-0.023880005,-0.0011177063,0.03213501,-0.034332275,0.0027999878,-0.054473877,0.017410278,0.014801025,0.038085938,-0.010635376,0.013885498,-0.019058228,0.039031982,-0.0053215027,0.028045654,-0.010429382,-0.021240234,-0.006580353,0.017059326,0.013954163,0.016479492,-0.016494751,-0.015312195,0.000705719,0.027664185,0.0048332214,-0.02319336,-0.017028809,-0.005268097,-0.025512695,-0.009338379,0.021896362,-0.009292603,0.04840088,0.0048217773,0.016647339,0.017181396,-0.039611816,-0.061584473,0.0051994324,0.05126953,0.07409668,0.03012085,-0.018966675,-0.043914795,-0.035705566,0.019058228,-0.01651001,0.036590576,-0.01576233,-0.044189453,-0.022766113,-0.036224365,-0.05996704,0.031082153,-0.013549805,0.016952515,-0.023773193,0.030929565,0.018341064,0.017868042,-0.018600464,0.0031032562,-0.026473999,-0.0028934479,0.07659912,-0.02204895,0.030822754,-0.019958496,0.017562866,-0.035949707,-0.022766113,-0.032989502,0.050354004,-0.018356323,-0.024017334,0.015357971,0.028198242,-0.010368347,-0.0154800415,0.029800415,-0.032348633,-0.032440186,-0.04019165,0.017288208,-0.019638062,0.031677246,0.02204895,0.020080566,0.057373047,-0.03793335,-0.009178162,-0.0231781,-0.0012683868,-0.031402588,-0.019104004,-0.018539429,-0.011619568,-0.0042762756,-0.0006337166,0.024841309,-0.0029678345,0.06500244,-0.006259918,0.010848999,0.01689148,-0.012313843,-0.027908325,0.017868042,0.023986816,-0.010795593,-0.005355835,-0.002248764,-0.04949951,0.041931152,-0.0017328262,0.0012931824,-0.0035057068,0.023284912,-0.0026378632,-0.027038574,0.0051651,0.022750854,0.004886627,-0.008590698,0.0027236938,0.016998291,-0.026535034,0.027404785,-0.033721924,0.03564453,0.0024089813,-0.02708435,-0.010559082,0.029251099,0.0034065247,-0.036193848,-0.0017614365,-0.0068473816,0.043395996,-0.033691406,0.06365967,-0.017608643,0.027542114,-0.02558899,0.00843811,0.025405884,-0.00039291382,-0.013534546,-0.0065841675,-0.012382507,-0.013763428,0.03552246,0.012138367,0.012611389,-0.042877197,0.0014476776,0.0009689331,-0.035125732,0.008735657,-0.021697998,0.027328491,0.020996094,0.00843811,-0.005718231,0.009529114,-0.025131226,0.02406311,-0.029769897,0.0043563843,-0.02204895,0.028640747,-0.033050537,0.029769897,-0.0051231384,0.020233154,0.011360168,-0.029571533,0.015205383,0.0102005005,0.015289307,0.009216309,-0.016555786,-0.009529114,-0.04837036,0.02935791,0.0035896301,-0.00856781,0.039642334,0.00068712234,0.00014424324,0.008049011,-0.00068473816,0.043640137,0.0038051605,-0.05444336,-0.01889038,0.017425537,0.004890442,0.006755829,0.011146545,-0.013290405,-0.033233643,-0.002336502,-0.020446777,-0.014060974,-0.003501892,-0.027908325,0.029907227,-0.006095886,0.020904541,-0.01828003,-0.04611206,-0.033447266,-0.024459839,0.019042969,-0.014129639,0.032684326,-0.00749588,0.027908325,-0.018936157,0.015625,0.02104187,0.042053223,-0.017654419,0.012359619,-0.012390137,0.06695557,0.021560669,0.0004529953,-0.00033020973,0.0030918121,-0.001709938,-0.046447754,0.017303467,0.02456665,-0.01914978,0.015151978,-0.042053223,-0.029006958,0.016494751,-0.020385742,0.018112183,0.022399902,0.040008545,0.00843811,-0.005256653,0.011924744,0.026535034,-0.024169922,0.029693604,-0.012161255,0.017425537,0.010391235,-0.02293396,0.010276794,-0.024475098,-0.03100586,-0.035705566,-0.07910156,0.0014820099,0.0184021,0.028793335,0.017456055,0.014099121,-0.004825592,-0.041229248,0.037475586,-0.029388428,0.0036239624,-0.0029354095,0.01927185,-0.016616821,-0.007896423,-0.0004146099,-0.01626587,0.017425537,0.04257202,-0.013755798,0.034606934,-0.0007724762,0.002544403,0.045196533,0.053253174,0.019821167,-0.02760315,0.0002105236,-0.023666382,-0.050811768,-0.008995056,-0.023788452,-0.022506714,-0.016143799,-0.008918762,-0.0031471252,0.003332138,-0.023757935,-0.015914917,-0.012832642,-0.010116577,0.024307251,-0.017303467,0.008552551,-0.0074157715,0.020996094,-0.016784668,-0.013397217,0.011405945,0.005783081,0.0082473755,0.011497498,-0.02645874,-0.01486969,-0.036499023,-0.005092621,0.0058555603,-0.0010547638,0.009941101,0.014381409,0.032989502,0.0045700073,0.0053634644,-0.021499634,0.03479004,-0.011543274,-0.037139893,0.0021915436,0.0013990402,0.0015659332,0.0039138794,0.048553467,-0.04510498,0.016540527,-0.0101623535,0.033203125,-0.02607727,-0.013519287,-0.05105591,0.021316528,-0.024169922,-0.01612854,-0.0042495728,-0.010543823,0.0038795471,-0.0074691772,-0.012939453,-0.05432129,-0.035491943,-0.019683838,-0.012771606,0.0012550354,0.04348755,0.0011138916,-0.08190918,-0.019317627,0.03213501,-0.04119873,0.0069847107,-0.017745972,-0.020858765,0.04309082,-0.015434265,-0.021713257,0.030258179,-0.042785645,-0.005405426,-0.022399902,0.04071045,0.022720337,0.033569336,-0.0026016235,0.002500534,-0.013366699,-0.041168213,0.015655518,-0.0003578663,0.011856079,-0.021957397,0.028503418,-0.016952515,0.032287598,0.045684814,-0.05218506,0.03050232,0.014427185,0.016860962,0.022476196,0.01637268,0.008613586,-0.014846802,-0.012298584,-0.009384155,-0.004096985,0.020950317,-0.0206604,0.031036377,0.03149414,0.018096924,-0.020263672,-0.04196167,0.026443481,0.0017690659,0.023757935,0.0048675537,0.0049324036,0.037475586,-0.017150879,0.0067100525,0.0010433197,0.028411865,0.014045715,-0.0078048706,-0.023712158,-0.05154419,0.0039100647,0.006126404,-0.023269653,-0.029220581,-0.008712769,0.0000743866,-0.013549805,0.02067566,0.010559082,0.0027122498,0.024597168,-0.0018081665,0.023712158,0.024765015,-0.007335663,0.0017309189,-0.0008010864,0.008628845,-0.021362305,0.006126404,0.0021362305,0.023971558,-0.006614685,0.0006480217,-0.011856079,-0.023468018,-0.0058403015,-0.0037250519,-0.055114746,0.0135269165,-0.023849487,0.025817871,0.0039863586,0.02394104,-0.038085938,-0.021621704,0.025024414,-0.0052223206,-0.026977539,0.039245605,0.02017212,-0.013755798,0.044281006,0.013343811,0.009010315,-0.006248474,0.026809692,-0.013214111,-0.0055007935,0.009796143,0.029846191,0.04345703,0.025222778,0.045410156,-0.02670288,0.032073975,0.032073975,0.005001068,-0.013389587,0.022506714,-0.0061836243,-0.036987305,0.024475098,-0.009727478,-0.028182983,-0.0041923523,0.016036987,0.003118515,-0.009887695,-0.05657959,0.040283203,-0.009719849,-0.008308411,0.0066604614,0.0028438568,0.0061149597,0.03414917,-0.006439209,0.0057373047,-0.013900757,0.022735596,0.014442444,0.003080368,0.032562256,0.006996155,-0.029464722,0.013870239,0.0032196045,-0.006816864,0.0022678375,0.010375977,-0.022262573,-0.009147644,-0.024658203,-0.014251709,-0.034118652,-0.0013284683,-0.03161621,0.052368164,0.022506714,0.05722046,0.0234375,0.02609253,0.016525269,-0.020111084,-0.050628662,0.0056037903,0.0042686462,0.0014019012,-0.017181396,0.020568848,0.011497498,-0.02558899,0.019302368,-0.0058288574,0.037902832,0.04257202,0.05166626,0.014328003,0.008476257,-0.0151901245,0.01940918,-0.014060974,0.053833008,-0.017471313,-0.03640747,-0.0052108765,0.01637268,-0.0012607574,0.011680603,0.056365967,0.00066137314,0.028182983,0.034484863,0.0039138794,-0.028656006,0.012062073,-0.04171753,0.013717651,0.023071289,0.03378296,-0.0018873215,-0.0061912537,0.01776123,-0.0063972473,-0.009788513,-0.03604126,0.036499023,0.08111572,0.0012283325,0.00014257431,-0.040740967,0.012268066,-0.035858154,-0.037231445,-0.010093689,-0.0017681122,0.01197052,0.010932922,-0.002166748,-0.011001587,-0.0023002625,-0.042236328,-0.027740479,-0.018936157,-0.010826111,0.043914795,-0.0021800995,0.0007982254,-0.03579712,0.0033359528,0.007724762,0.0029449463,0.035614014,0.0054244995,0.015686035,0.012382507,0.015792847,-0.004463196,0.034606934,0.025161743,0.014801025,-0.024337769,0.01247406,0.005970001,-0.0126571655,0.02671814,0.01966858,0.031036377,0.02420044,0.027954102,0.021820068,-0.015930176,0.02633667,-0.0053253174,0.022918701,0.015029907,0.012550354,0.008979797,-0.030227661,0.028305054,0.024414062,-0.0048065186,0.0027656555,-0.016464233,-0.016601562,0.0004131794,0.024780273,0.012672424,0.0056266785,-0.013465881,-0.0066871643,0.013008118,0.006549835,-0.006149292,0.022460938,0.009422302,0.018920898,0.0340271,-0.01789856,0.021713257,-0.0099105835,-0.0087890625,-0.0011587143,-0.0063934326,-0.015380859,-0.009056091,0.048339844,0.020446777,0.04220581,0.018478394,0.018997192,-0.019500732,-0.02104187,0.006038666,0.014152527,0.015045166,-0.023132324,-0.02494812,0.015792847,0.020233154,-0.0042266846,-0.0002822876,0.0231781,0.027008057,0.017700195,-0.012939453,0.0072746277,0.01576233,-0.0058898926,0.024383545,0.01449585,0.02709961,0.0021095276,0.039001465,0.015914917,-0.02722168,-0.0025119781,0.033599854,-0.002105713,-0.023330688,0.01802063,0.007709503,0.006958008,0.00036001205,0.020751953,-0.005569458,0.023544312,0.011894226,0.02494812,-0.00092601776,-0.019729614,0.011360168,0.008071899,0.0008983612,0.021575928,0.006881714,-0.0036029816,-0.05029297,0.0015125275,-0.019134521,0.020736694,-0.006263733,-0.010017395,-0.00064086914,-0.01637268,0.042755127,0.008712769,-0.023605347,0.07116699,0.022705078,-0.027694702,-0.0056610107,-0.038879395,0.03692627,0.024856567,0.00573349,0.008964539,-0.00096797943,0.0053100586,0.023956299,0.012931824,-0.00045132637,0.03955078,-0.009056091,-0.010681152,-0.004535675,0.014045715,-0.00793457,0.024002075,0.002067566,0.020767212,0.00004941225,-0.0079956055,-0.002626419,0.0014505386,0.020019531,0.021957397,0.0033054352,-0.0059013367,-0.018692017,-0.012809753,0.027389526,-0.0025291443,-0.018615723,0.0049819946,0.022872925,-0.018539429,0.019592285,0.025054932,-0.016494751,-0.010032654,-0.026565552,-0.014656067,-0.007858276,0.033203125,0.026733398,0.0076560974,-0.007751465,-0.015670776,0.005130768,0.02519226,0.0008907318,0.05130005,0.03387451,0.009300232,0.0066604614,0.0028038025,-0.029418945,0.007785797,0.021697998,-0.0033245087,-0.005191803,-0.015464783,-0.0236969,0.0035820007,0.001452446,-0.013687134,0.0046958923,0.02166748,0.005710602,0.016998291,0.023513794,0.025421143,0.011184692,-0.021408081,0.024261475,-0.0027561188,0.0072746277,-0.0104904175,0.02798462,0.029418945,0.022460938,-0.04220581,0.031173706,0.0060195923,0.024108887,-0.017745972,-0.0076293945,-0.014266968,-0.010765076,0.0030708313,-0.0061569214,0.017333984,0.008331299,-0.01927185,-0.017837524,0.032196045,-0.00030875206,0.0045661926,0.025344849,0.013412476,0.028366089,-0.02432251,-0.0138168335,-0.023254395,0.0317688,-0.03753662,-0.003967285,-0.0072746277,-0.032348633,-0.008140564,-0.0057868958,0.026351929,0.020614624,-0.0007033348,-0.015419006,-0.013916016,0.0063819885,0.059631348,0.00289917,-0.016784668,0.022842407,-0.0072746277,0.017166138,0.025466919,-0.01121521,-0.0062713623,0.01007843,0.0052108765,-0.023132324,0.02482605,-0.011878967,-0.013793945,0.028900146,0.015853882,-0.021408081,0.028686523,0.0008301735,0.0037136078,0.0012645721,0.0017642975,-0.032806396,0.02619934,0.01902771,0.009857178,-0.018234253,0.009460449,-0.016601562,-0.02645874,0.0055007935,0.0047950745,0.009353638,0.0076789856,-0.018859863,-0.002040863,-0.019592285,0.0015659332,0.015327454,0.012931824,-0.016921997,-0.061920166,-0.015434265,-0.006134033,-0.009590149,-0.023788452,0.014778137,0.03970337,0.052856445,0.02015686,-0.015556335,0.0074005127,0.008964539,0.014625549,0.010444641,-0.0011644363,0.012245178,-0.01361084,-0.04208374,0.0027942657,-0.02720642,0.019577026,-0.039367676,0.008171082,-0.023925781,0.007247925,-0.0051078796,0.016921997,0.009170532,0.0262146,-0.036315918,-0.00762558,-0.0023002625,0.0446167,0.025863647,0.009223938,-0.008529663,0.000019669533,-0.0028800964,0.023849487,0.009918213,-0.01171875,0.017089844,-0.029464722,0.02532959,0.0018167496,-0.006122589,-0.005153656,0.017959595,-0.003118515,0.021392822,0.016860962,0.002035141,0.0027942657,-0.031402588,-0.015716553,0.015464783,0.012413025,-0.011177063,-0.008110046,0.012931824,-0.020080566,-0.019180298,-0.004558563,0.0011663437,-0.006134033,-0.0024738312,0.0026474,0.035705566,-0.0085372925,-0.034729004,0.016052246,0.0007414818,0.0055999756,-0.046691895,0.016326904,-0.02394104,0.016937256,0.012008667,0.0075569153,-0.017028809,0.009941101,0.032165527,-0.021194458,-0.03390503,0.029449463,0.018249512,-0.021911621,-0.017990112,-0.011230469,0.027664185,0.0051879883,0.0022125244,-0.0062294006,-0.0041389465,0.013038635,0.01637268,-0.0032215118,0.025634766,-0.011947632,-0.009475708,0.00047516823,-0.0047454834,-0.016220093,0.03137207,-0.023971558,-0.0030975342,-0.010169983,0.0011224747,0.026565552,0.0069618225,0.022720337,0.013557434,-0.0014286041,0.01739502,0.010848999,0.0032901764,0.03289795,-0.007408142,0.0067214966,-0.015899658,0.011306763,0.01725769,-0.028717041,-0.03111267,-0.0077171326,0.010803223,0.03652954,0.0035057068,0.0055351257,0.020874023,-0.02079773,-0.003774643,-0.0070114136,-0.010665894,0.0033397675,-0.028961182,0.038513184,0.004447937,-0.028289795,-0.018432617,-0.002445221,-0.012321472,-0.008674622,-0.002729416,-0.008300781,0.01953125,0.0149002075,-0.0005669594,-0.025863647,0.022338867,0.0005707741,-0.025222778,0.037628174,-0.015808105,0.010749817,0.017074585,-0.0074882507,0.032073975,0.03125,0.019104004,0.050750732,-0.013977051,-0.004016876,0.019851685,-0.0022468567,0.015464783,0.011428833,-0.020370483,0.00025248528,0.010551453,0.004722595,0.013320923,-0.007949829,0.035369873,0.06298828,0.015625,0.03414917,-0.042266846,-0.01687622,-0.017578125,0.015960693,-0.026412964,0.018188477,0.019454956,-0.002445221,-0.009132385,-0.027435303,0.023162842,0.02494812,0.066711426,0.004169464,-0.021987915,-0.02911377,-0.00869751,0.017364502,-0.0052375793,-0.037322998,-0.01838684,0.011955261,0.009361267,0.010040283,0.026550293,-0.03491211,0.009132385,0.027740479,-0.039764404,-0.04876709,0.033599854,0.016235352,-0.012588501,-0.013069153,-0.03274536,0.019897461,-0.00037193298,0.028793335,-0.024047852,0.001247406,-0.01763916,0.029251099,0.021102905,0.016845703,-0.0135269165,0.036468506,-0.013252258,-0.010635376,0.011726379,-0.03451538],"createdAt":"2026-04-18T19:59:16.178Z","updatedAt":"2026-04-22T02:45:05.537Z","lastSeenAt":"2026-04-22T02:45:05.537Z","tsv":"'0.01':142 '1':153 '10':149 '25':204 '3.1.0':168 'TGM perp trades' 'accept':90 'across':203 'action':62,113 'add/reduce/open/close':64 'address':58,111 'analyt':15,30,194 'api':159,163,173 'authent':171 'bodi':96 'broader':189 'btc':102 'call':144 'chain':205 'contract':87 'cost':141 'cover':78,191 'credit':136,150,154 'credit-usag':135 'data':36,77 'date':105 'date-range-filtering' 'derivatives trading data' 'document':165 'e.g':101 'endpoint':32,89,140,184 'eth':103 'filter':108 'flow':198 'free':151 'god':13,28,47 'hash':75 'header':138 'histori':3,18 'hyperliquid':8,23,42,85 'hyperliquid trades' 'hyperliquid-perps' 'includ':56,126 'individu':53 'json':95 'key':160,174 'label':118 'limit':133 'long-short-positions' 'long/short':61 'market':200 'market-limit-orders' 'market/limit':67 'mode':14,29,48 'money':80,117,193 'nansen':10,25,44,161 'nansen perp trades' 'openapi':167 'option':107 'order':65,114,124 'pagin':121,127 'pagination' 'part':186 'pay':178 'pay-per-request':177 'per':143,179 'perp':182 'perp trades' 'perpetu':1,16,34,86 'perpetual futures trades' 'perpetual-trades' 'post':91 'predict':199 'price':68 'price/value':119 'pro':155 'profil':196 'protocol':147 'rang':106,120 'rate':132 'rate-limit':131 'record':55,129 'request':92,180 'respons':125 'retriev':33 'return':52 'side':60,112 'size':69 'smart':79,116,192 'smart-money-filtering' 'sort':123 'sorting' 'specif':39 'specifi':97 'suit':50,190 'support':170 'symbol':100 'tgm':49 'tier':152,156 'token':6,12,21,27,40,46,99,197 'token perp history' 'token-god-mode' 'trade':2,17,35,54,59,128,183 'trade-history' 'trader':57,83,110 'transact':74 'type':63,66,115 'usag':137 'usd':72 'valu':70 'via':9,24,145,166,172 'wallet':195 'x402':146,176","prices":[{"id":"1a192433-a8df-42b2-b6b0-764183869106","listingId":"18d3125b-fe0b-4761-bbda-a534354316dc","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":"Perp trading history for a token"},"asset_contract":"0x20c000000000000000000000b9537d11c60e8b50"},"createdAt":"2026-04-18T19:59:16.178Z"}],"sources":[{"listingId":"18d3125b-fe0b-4761-bbda-a534354316dc","source":"mpp_dev","sourceId":"nansen:POST:/api/v1/tgm/perp-trades","sourceUrl":"https://mpp.dev/api/services","isPrimary":true,"firstSeenAt":"2026-04-18T19:59:16.178Z","lastSeenAt":"2026-04-22T02:45:05.537Z"}],"details":{"listingId":"18d3125b-fe0b-4761-bbda-a534354316dc","quickStartSnippet":"curl -X POST https://api.nansen.ai/api/v1/tgm/perp-trades \\\n  -H 'Content-Type: application/json' \\\n  -H 'apiKey: YOUR_API_KEY' \\\n  -d '{\n    \"token_symbol\": \"BTC\",\n    \"date\": {\"from\": \"2025-01-01T00:00:00Z\", \"to\": \"2025-01-02T23:59:59Z\"},\n    \"pagination\": {\"page\": 1, \"per_page\": 10}\n  }'","exampleRequest":{"date":{"to":"2025-01-02T23:59:59Z","from":"2025-01-01T00:00:00Z"},"filters":{"side":"Long","order_type":["MARKET"]},"order_by":[{"field":"block_timestamp","direction":"DESC"}],"pagination":{"page":1,"per_page":10},"token_symbol":"BTC"},"exampleResponse":{"data":[{"side":"Long","type":"MARKET","action":"Add","price_usd":95000,"value_usd":47500,"token_amount":0.5,"token_symbol":"BTC","trader_address":"0x28c6c06298d514db089934071355e5743bf21d60","block_timestamp":"2025-01-02T18:30:00Z","transaction_hash":"0xabc123...","trader_address_label":"Smart Money"}],"pagination":{"page":1,"per_page":10,"is_last_page":false}},"schema":{"path":"/api/v1/tgm/perp-trades","method":"POST","payment":{"amount":"10000","intent":"charge","method":"tempo","currency":"0x20c000000000000000000000b9537d11c60e8b50","decimals":6,"description":"Perp trading history for a token"},"description":"Perp trading history for a token"},"openapiUrl":null,"agentsTxtUrl":null,"citations":[{"claim":"Endpoint is POST /api/v1/tgm/perp-trades with x402 payment at $0.01 per call","source_url":"https://api.nansen.ai"},{"claim":"Supports Hyperliquid perpetual contracts only with smart money filtering, side/action/order_type filters","source_url":"https://api.nansen.ai"},{"claim":"Credit cost is 10 (free tier) or 1 (pro tier) per call","source_url":"https://api.nansen.ai"},{"claim":"API root returns 200 with ok message confirming the service is live","source_url":"https://api.nansen.ai"}],"useCases":["Track all perpetual trades for a specific token on Hyperliquid within a date range","Filter perpetual trades by smart money labels to see what sophisticated traders are doing","Analyze Long vs Short trade activity and Open/Close patterns for a token","Monitor large-value perpetual trades by setting USD value filters","Build trading signals from real-time perp trade flow data"],"bestFor":["Crypto traders monitoring Hyperliquid perpetual contract activity","Quant researchers analyzing derivatives trade flow by token","Smart money tracking for perpetual futures positions","Building dashboards showing perp trade activity for specific assets"],"notFor":["Spot/DEX trade data (use /tgm/dex-trades instead)","Historical perp data beyond Hyperliquid (only Hyperliquid is supported)","Real-time streaming trades (this is a polling/REST endpoint)"],"kindDetails":{"docs":{"homepage":"https://docs.nansen.ai","apiReference":"https://docs.nansen.ai/nansen-api-reference"},"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market"],"realm":"api.nansen.ai","status":"active","methods":{"tempo":{"assets":["0x20c000000000000000000000b9537d11c60e8b50"],"intents":["charge"]}},"provider":{"url":"https://nansen.ai","name":"Nansen"},"categories":["blockchain","data"],"service_id":"nansen","integration":"first-party","service_name":"Nansen","service_description":"Blockchain analytics and smart money intelligence. Token data, wallet profiling, DEX trades, PnL, and flow analysis across multiple chains."},"updatedAt":"2026-04-22T02:45:05.537Z"}}