{"uid":"cap_fiaU5cXKE2nATSTSehBe2","slug":"x402stock-perpetuals-trade-fills-by-address-1c88dd80","name":"x402stock Perpetuals Trade Fills by Address","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/perps/fills/%7Baddress%7D","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["limit"],"properties":{"limit":{"type":"integer","default":50,"maximum":200,"exclusiveMinimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["source","as_of","venue","market","address","count","fills"],"properties":{"as_of":{"type":"string"},"count":{"type":"number"},"fills":{"type":"array","items":{"type":"object","required":["time","coin","side","direction","price","size","start_position","closed_pnl","fee","fee_token","crossed","order_id","hash"],"properties":{"fee":{"anyOf":[{"type":"number"},{"type":"null"}]},"coin":{"type":"string"},"hash":{"type":"string"},"side":{"anyOf":[{"enum":["buy","sell"],"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"time":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"crossed":{"type":"boolean"},"order_id":{"type":"number"},"direction":{"type":"string"},"fee_token":{"type":"string"},"closed_pnl":{"anyOf":[{"type":"number"},{"type":"null"}]},"start_position":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"venue":{"type":"string"},"market":{"type":"string","const":"perp"},"source":{"type":"string","const":"x402stock"},"address":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-06-06T00:00:00.000Z","count":1,"fills":[{"fee":0,"coin":"ZEC","hash":"0x3ec9f70625e67c4c4043043d26d20a02023400ebc0e99b1ee292a258e4ea5636","side":"sell","size":0.42,"time":"2026-06-06T00:00:00.000Z","price":385.15,"crossed":false,"order_id":461295386790,"direction":"Open Short","fee_token":"USDC","closed_pnl":0,"start_position":-50.63}],"venue":"hyperliquid","market":"perp","source":"x402stock","address":"0x31ca8395cf837de08b24da3f660e77761dfb974b"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hfYPm-MCQZtybf0YNVKmP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves on-chain perpetual futures trade fill history for a given wallet address from Hyperliquid via a pay-per-call API","exampleAgentPrompt":"Pull the last 100 perp trade fills for wallet address 0x31ca8395cf837de08b24da3f660e77761dfb974b from x402stock — I want to see the coins traded, direction, price, size, and any closed PnL.","exampleUseCases":null,"resultDescription":"A JSON object containing the wallet address, venue (hyperliquid), market type (perp), timestamp, fill count, and an array of fill records each with coin, side, direction, price, size, start position, closed PnL, fee, fee token, order ID, and transaction hash.","failureModes":["Invalid or malformed wallet address returns an error or empty fills array","limit parameter out of range (<=0 or >200) returns a validation error","Address has no perp trade history — returns count:0 and empty fills array","Hyperliquid data source unavailable — upstream timeout or 5xx error","Payment not completed via x402/USDC — 402 Payment Required response blocking data"],"whenToPreferThis":"Use this endpoint when you need on-chain perpetual futures fill history for a specific wallet address sourced from Hyperliquid, paid per-call in USDC with no API key or account required. Prefer this over traditional brokerage or CEX APIs when querying DeFi/on-chain perp activity, or when you need a no-subscription micropayment model for agent-driven data access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T12:58:23.523Z","isFirstParty":false}