{
"success": false,
"message": "Too many requests"
}
{
"success": false,
"message": "Internal Server Error"
}
Usage Note
Accessibility
Chain Supported
Returns historical perpetual trade fills for one Hyperliquid wallet.
Use sort_type to read fills in ascending or descending time order.
Use the returned nextCursor as cursor in the next request.
limit defaults to 10 and supports up to 20 records per request.
Lite
Starter
Premium
Business
Enterprise
Hyperliquid
Compute Unit ⚙️
This endpoint consumes 5 CU per request.
Use Cases 💡
Build a wallet’s perpetual execution history.
Analyze entry and exit activity, realized PnL, fees, and traded volume.
Support trader attribution, performance review, and position lifecycle analysis.
How to Use 🛠️
Pass a Hyperliquid wallet address in the request body.
Start with an empty cursor and use nextCursor to continue pagination.
Use sort_type=desc for the newest fills first or sort_type=asc for chronological processing.
Best Practices ✅
Persist the cursor when processing long histories.
Deduplicate by transaction hash when combining pages or polling repeatedly.
Combine fills with Wallet Open Positions to compare execution history with current exposure.
Authorizations
X-API-KEY
string
header
required
API key for authentication
Body
application/json
wallet
string
required
Example:
"0x5b5d51203a0f9079f8aeb098a6523a13f298c060"
sort_type
enum<string>
default:desc
Available options:
asc,
desc
limit
integer
default:10
Required range: 1 <= x <= 20
cursor
string
default:""
Response
JSON object containing a list of trade fills with certain fields
success
boolean
required
data
object
required
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Birdeye Data","description":"Birdeye Data is a decision-grade data provider that delivers real-time, accurate on-chain data across tokens, wallets, trades, and protocols.","colors":{"primary":"#009661","light":"#00FFA3","dark":"#009661"},"logo":{"light":"https://mintcdn.com/birdeye/avRdMljk5iuSQU-x/images/verticalBlacklogotransparent.png?fit=max\u0026auto=format\u0026n=avRdMljk5iuSQU-x\u0026q=85\u0026s=66c9a20003a9b05e5f02f687c112b12f","dark":"https://mintcdn.com/birdeye/avRdMljk5iuSQU-x/images/verticalwhitelogotransparent.png?fit=max\u0026auto=format\u0026n=avRdMljk5iuSQU-x\u0026q=85\u0026s=0e1fb8061e7afdb2153a3d4bd79e55ea"},"favicon":{"light":"https://mintcdn.com/birdeye/URww_x_ElI0MfV9M/images/light-favicon.png?fit=max\u0026auto=format\u0026n=URww_x_ElI0MfV9M\u0026q=85\u0026s=e0f0b1f7f861054132348ba2c9a636e5","dark":"https://mintcdn.com/birdeye/URww_x_ElI0MfV9M/images/dark-favicon.png?fit=max\u0026auto=format\u0026n=URww_x_ElI0MfV9M\u0026q=85\u0026s=af2ad471f2115e37535813e28a147bea"},"api":{"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["curl","python","javascript"],"prefill":true}},"appearance":{"default":"system"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://birdeye.so/data-api/blog","label":"Blog "},{"href":"https://birdeye.so/data-api","label":"Website "}],"primary":{"type":"button","label":"Go to Dashboard","href":"https://data.birdeye.so/user/account/billing?tab=overview"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/birdeyedata","x":"https://x.com/birdeye_data","youtube":"https://www.youtube.com/@birdeye_data"},"links":[{"header":"Product","items":[{"label":"Types of Data","href":"https://birdeye.so/data-api/types-of-data"},{"label":"Use Cases ","href":"https://data.birdeye.so/docs/use-cases/overview"},{"label":"Pricing ","href":"https://birdeye.so/data-api/pricing"},{"label":"Referral","href":"https://birdeye.so/data-api/referral"}]},{"header":"Company","items":[{"label":"Contact us","href":"https://birdeye.so/data-api/contact"},{"label":"Privacy Policy","href":"https://birdeye.so/data-api/privacy-policy"},{"label":"Terms \u0026 Conditions","href":"https://birdeye.so/data-api/terms-of-service"},{"label":"Disclaimers","href":"https://birdeye.so/data-api/disclaimer"}]},{"header":"Birdeye's Suite","items":[{"label":"Birdeye Terminal ","href":"https://birdeye.so/"},{"label":"Institutional Dashboard","href":"https://birdeye.so/peak"},{"label":"Research \u0026 Insights","href":"https://birdeye.so/research"}]}]},"seo":{"metatags":{"og:image":"https://data.birdeye.so/docs/images/Birdeye-Data-API-Docs.png","twitter:image":"https://data.birdeye.so/docs/images/Birdeye-Data-API-Docs.png"}},"fonts":{"heading":{"family":"Geist"},"body":{"family":"Geist"}},"icons":{"library":"fontawesome"},"integrations":{"ga4":{"measurementId":"G-RN1GQWESZC"}},"banner":{"content":"Arc Trading Data Available on Birdeye Data API from Day 1. [Check it out!](https://birdeye.so/data-api/blog/detail/arc-trading-data-available-on-birdeye-data-from-day-1?utm_source=banner\u0026utm_medium=docsbanner\u0026utm_campaign=docshead)","dismissible":true,"color":{"light":"#5A646F","dark":"#5A646F"}},"contextual":{"options":["chatgpt","claude","copy"],"display":"header"},"thumbnails":{"appearance":"dark","fonts":{"family":"Geist"}},"interaction":{"drilldown":false},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"birdeye","hasAudioNarration":false,"actualSubdomain":"birdeye","customDomains":["data.birdeye.so"],"gitSource":{"type":"github","owner":"dangquocdat97","repo":"bds-docs-mintlify","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true,"thumbs":true},"entitlements":{},"buildId":"6afbf8e3df5617432858e955","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Changelog","count":210},{"language":"default","tag":"API Reference","count":104},{"language":"default","tag":"Birdeye Data API","count":98},{"language":"default","tag":"Welcome","count":37},{"language":"default","tag":"Use Cases","count":30},{"language":"default","tag":"Guides","count":22},{"language":"default","tag":"WebSockets","count":22},{"language":"default","tag":"Price \u0026 OHLCV","count":17},{"language":"default","tag":"Wallet, Networth \u0026 PnL","count":17},{"language":"default","tag":"Stats \u0026 Market Data","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"perps-api/perps-wallet/post-perps-v1-wallet-trade-fills","slug":"/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills","pageMetadata":{"title":"Perps Wallet Trade Fills","hidden":false,"metadata":{"title":"Perps Data API | Perps Wallet Trade Fills","keywords":["blockchain","data","crypto","trading","birdeye","perps","hyperliquid"],"robots":"index"},"openapi":"openapi/perps/openapi_perps_docs.json POST /perps/v1/wallet/trade_fills","description":"Get a wallet's perp trade fills, with price, size, side, and fees for each fill. Use it to audit a trader's history.","keywords":["perp trade fills","fills history","trader fees","trade audit"],"href":"/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills","hiddenSetByFrontmatter":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Get a wallet’s perp trade fills, with price, size, side, and fees for each fill. Use it to audit a trader’s history.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Tab,Tabs}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);return _jsxs(_Fragment,{children:[_jsxs(Tabs,{children:[_jsx(Tab,{title:`Usage Note`,id:`usage-note`,children:_jsxs(`ul`,{children:[_jsx(`li`,{children:`Returns historical perpetual trade fills for one Hyperliquid wallet.`}),_jsxs(`li`,{children:[`Use `,_jsx(`code`,{children:`sort_type`}),` to read fills in ascending or descending time order.`]}),_jsxs(`li`,{children:[`Use the returned `,_jsx(`code`,{children:`nextCursor`}),` as `,_jsx(`code`,{children:`cursor`}),` in the next request.`]}),_jsxs(`li`,{children:[_jsx(`code`,{children:`limit`}),` defaults to `,_jsx(`code`,{children:`10`}),` and supports up to `,_jsx(`code`,{children:`20`}),` records per request.`]})]})}),_jsx(Tab,{title:`Accessibility`,id:`accessibility`,children:_jsxs(`ul`,{children:[_jsx(`li`,{children:`Lite`}),_jsx(`li`,{children:`Starter`}),_jsx(`li`,{children:`Premium`}),_jsx(`li`,{children:`Business`}),_jsx(`li`,{children:`Enterprise`})]})}),_jsx(Tab,{title:`Chain Supported`,id:`chain-supported`,children:_jsx(`p`,{children:_jsx(`strong`,{children:`Hyperliquid`})})})]}),`\n`,_jsx(Accordion,{title:`Compute Unit ⚙️`,icon:`fa-gauge-high`,id:`compute-unit`,children:_jsx(`ul`,{children:_jsxs(`li`,{children:[`This endpoint consumes `,_jsx(`code`,{children:`5 CU`}),` per request.`]})})}),`\n`,_jsx(Accordion,{title:`Use Cases 💡`,icon:`fa-lightbulb`,id:`use-cases`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Build a wallet’s perpetual execution history.`}),`\n`,_jsx(_components.li,{children:`Analyze entry and exit activity, realized PnL, fees, and traded volume.`}),`\n`,_jsx(_components.li,{children:`Support trader attribution, performance review, and position lifecycle analysis.`}),`\n`]})}),`\n`,_jsx(Accordion,{title:`How to Use 🛠️`,icon:`fa-book-open`,id:`how-to-use`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Pass a Hyperliquid wallet address in the request body.`}),`\n`,_jsxs(_components.li,{children:[`Start with an empty cursor and use `,_jsx(_components.code,{children:`nextCursor`}),` to continue pagination.`]}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`sort_type=desc`}),` for the newest fills first or `,_jsx(_components.code,{children:`sort_type=asc`}),` for chronological processing.`]}),`\n`]})}),`\n`,_jsx(Accordion,{title:`Best Practices ✅`,icon:`fa-check-circle`,id:`best-practices`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Persist the cursor when processing long histories.`}),`\n`,_jsx(_components.li,{children:`Deduplicate by transaction hash when combining pages or polling repeatedly.`}),`\n`,_jsx(_components.li,{children:`Combine fills with Wallet Open Positions to compare execution history with current exposure.`}),`\n`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Perps Wallet Trade Fills","hidden":false,"metadata":{"title":"Perps Data API | Perps Wallet Trade Fills","keywords":["blockchain","data","crypto","trading","birdeye","perps","hyperliquid"],"robots":"index"},"openapi":"openapi/perps/openapi_perps_docs.json POST /perps/v1/wallet/trade_fills","description":"Get a wallet's perp trade fills, with price, size, side, and fees for each fill. Use it to audit a trader's history.","keywords":["perp trade fills","fills history","trader fees","trade audit"],"href":"/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills","hiddenSetByFrontmatter":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"x-metadata":{"released_at":1778803200,"new":true},"tags":["Perps - Wallet"],"summary":"Perps - Wallet Trade Fills","description":"Get a wallet's perp trade fills, with price, size, side, and fees for each fill. Use it to audit a trader's history.","requestBody":"ad8a92db-87f5-4927-b403-beb6f791d65a","responses":{"200":"e8113e05-7312-4c5f-8a8f-c8e5a8329be3","400":"d39d2159-3be6-48e6-bc5d-f1086bb92495","401":"e26066ad-18d1-41c6-875a-aeb626fad170","403":"49610e80-8f52-4988-8c0b-2e8ecef2301f","429":"22c19b78-68f4-4f5d-a2f3-610d3159bbde","500":"0c0a53b5-b0bc-4a47-9445-19b30c7d5ef5"},"operationId":"post-perps-v1-wallet-trade_fills","method":"post","type":"path","servers":["bbf51ed4-3b70-4ec5-80db-830abef72f02"],"security":["d89a72cd-2910-43db-869a-0778873690ed"],"path":"/perps/v1/wallet/trade_fills","baseUrlOptions":["https://public-api.birdeye.so"],"title":"Perps - Wallet Trade Fills","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.wallet":"0x5b5d51203a0f9079f8aeb098a6523a13f298c060","body.sort_type":"desc","body.limit":1,"body.cursor":"MHg1YjVkNTEyMDNhMGY5MDc5ZjhhZWIwOThhNjUyM2ExM2YyOThjMDYwLTE3ODkzNDM4NzcwMjgtMHhjOTYxNTY5MmM1YjQ0ZWJjY2FkYjA0NDQ1OGE4NDcwMjAyNDgwMDc4NjBiNzZkOGU2ZDJhMDFlNTg0YjgyOGE3"}]},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["wallet"],"type":"object","properties":{"wallet":{"type":"string","example":"0x5b5d51203a0f9079f8aeb098a6523a13f298c060","isRequired":true,"uniqueKey":"wallet","typeLabel":"string"},"sort_type":{"type":"string","enum":["asc","desc"],"default":"desc","uniqueKey":"sort_type","typeLabel":"enum\u003cstring>"},"limit":{"type":"integer","default":10,"minimum":1,"maximum":20,"uniqueKey":"limit","typeLabel":"integer"},"cursor":{"type":"string","default":"","uniqueKey":"cursor","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"WalletTradeFills":{"title":"WalletTradeFills","value":{"wallet":"0x5b5d51203a0f9079f8aeb098a6523a13f298c060","sort_type":"desc","limit":1,"cursor":"MHg1YjVkNTEyMDNhMGY5MDc5ZjhhZWIwOThhNjUyM2ExM2YyOThjMDYwLTE3ODkzNDM4NzcwMjgtMHhjOTYxNTY5MmM1YjQ0ZWJjY2FkYjA0NDQ1OGE4NDcwMjAyNDgwMDc4NjBiNzZkOGU2ZDJhMDFlNTg0YjgyOGE3"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"e8113e05-7312-4c5f-8a8f-c8e5a8329be3":{"description":"JSON object containing a list of trade fills with certain fields","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"WalletTradeFills":{"title":"WalletTradeFills","value":{"data":{"data":[{"time":1789343885,"hash":"0x1ac3874b7d5799501c3d044458a8ad0205540031185ab822be8c329e3c5b733a","token":"PUMP","side":"Buy","direction":"Close Short","size":2881240,"volume_usd":9997.9028,"start_position":-3411528597,"closed_pnl":3275.96988,"fee_value":2.099559,"price":0.00347}],"nextCursor":"MHg1YjVkNTEyMDNhMGY5MDc5ZjhhZWIwOThhNjUyM2ExM2YyOThjMDYwLTE3ODkzNDM4NzcwMjgtMHhjOTYxNTY5MmM1YjQ0ZWJjY2FkYjA0NDQ1OGE4NDcwMjAyNDgwMDc4NjBiNzZkOGU2ZDJhMDFlNTg0YjgyOGE3"},"success":true}}},"exampleType":"examples"}},"exampleType":"examples"},"d39d2159-3be6-48e6-bc5d-f1086bb92495":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Bad request"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Bad request"}}},"exampleType":"examples"}},"exampleType":"examples"},"e26066ad-18d1-41c6-875a-aeb626fad170":{"description":"Unauthorized. API key is missing or invalid","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Unauthorized"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Unauthorized"}}},"exampleType":"examples"}},"exampleType":"examples"},"49610e80-8f52-4988-8c0b-2e8ecef2301f":{"description":"Forbidden. Request is blacklisted or not whitelisted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Access Denied"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Access Denied"}}},"exampleType":"examples"}},"exampleType":"examples"},"22c19b78-68f4-4f5d-a2f3-610d3159bbde":{"description":"Too Many Requests. Rate limit reached","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Too many requests"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Too many requests"}}},"exampleType":"examples"}},"exampleType":"examples"},"0c0a53b5-b0bc-4a47-9445-19b30c7d5ef5":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Internal Server Error"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Internal Server Error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"d89a72cd-2910-43db-869a-0778873690ed":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"API key for authentication","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"bbf51ed4-3b70-4ec5-80db-830abef72f02":{"url":"https://public-api.birdeye.so"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"API key for authentication","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"X-API-KEY","type":"string","description":"API key for authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"X-API-KEY"}],"title":"apiKeyAuth"}]},"originalFileLocation":"openapi/perps/openapi_perps_docs.json"},"subdomain":"birdeye","siteName":"Birdeye Data","title":"Perps Wallet Trade Fills - Birdeye Data","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T06:49:24.747Z","originalFileLocation":"perps-api/perps-wallet/post-perps-v1-wallet-trade-fills.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get a wallet\u0026#x27;s perp trade fills, with price, size, side, and fees for each fill. Use it to audit a trader\u0026#x27;s history.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Birdeye Data\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/birdeye/8d_GaeRlUKE10QqE/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/birdeye/8d_GaeRlUKE10QqE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/birdeye/8d_GaeRlUKE10QqE/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/birdeye/8d_GaeRlUKE10QqE/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/birdeye/8d_GaeRlUKE10QqE/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/birdeye/8d_GaeRlUKE10QqE/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/birdeye/8d_GaeRlUKE10QqE/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/birdeye/8d_GaeRlUKE10QqE/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/birdeye/8d_GaeRlUKE10QqE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Perps Wallet Trade Fills - Birdeye Data\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a wallet\u0026#x27;s perp trade fills, with price, size, side, and fees for each fill. Use it to audit a trader\u0026#x27;s history.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Birdeye Data\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://data.birdeye.so/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://data.birdeye.so/docs/images/Birdeye-Data-API-Docs.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Perps Wallet Trade Fills - Birdeye Data\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a wallet\u0026#x27;s perp trade fills, with price, size, side, and fees for each fill. Use it to audit a trader\u0026#x27;s history.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://data.birdeye.so/docs/images/Birdeye-Data-API-Docs.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/birdeye/8d_GaeRlUKE10QqE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Birdeye Data\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#009661\">\u003clink data-mint-head rel=\"canonical\" href=\"https://data.birdeye.so/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://data.birdeye.so/#organization\",\"name\":\"Birdeye Data\",\"url\":\"https://data.birdeye.so\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/birdeye/avRdMljk5iuSQU-x/images/verticalBlacklogotransparent.png?fit=max\u0026auto=format\u0026n=avRdMljk5iuSQU-x\u0026q=85\u0026s=66c9a20003a9b05e5f02f687c112b12f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://data.birdeye.so/docs#website\",\"name\":\"Birdeye Data\",\"url\":\"https://data.birdeye.so/docs\",\"publisher\":{\"@id\":\"https://data.birdeye.so/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://data.birdeye.so/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills#webpage\",\"url\":\"https://data.birdeye.so/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills\",\"name\":\"Perps Wallet Trade Fills\",\"description\":\"Get a wallet's perp trade fills, with price, size, side, and fees for each fill. Use it to audit a trader's history.\",\"dateModified\":\"2026-11-17T06:49:24.747Z\",\"isPartOf\":{\"@id\":\"https://data.birdeye.so/docs#website\"},\"breadcrumb\":{\"@id\":\"https://data.birdeye.so/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://data.birdeye.so/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Perps Data API\",\"item\":\"https://data.birdeye.so/docs/perps-api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Perps Wallet\",\"item\":\"https://data.birdeye.so/docs/perps-api/perps-wallet\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Perps Wallet Trade Fills\",\"item\":\"https://data.birdeye.so/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://data.birdeye.so/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills#apireference\",\"headline\":\"Perps Wallet Trade Fills\",\"name\":\"Perps Wallet Trade Fills\",\"description\":\"Get a wallet's perp trade fills, with price, size, side, and fees for each fill. Use it to audit a trader's history.\",\"url\":\"https://data.birdeye.so/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills\",\"mainEntityOfPage\":{\"@id\":\"https://data.birdeye.so/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills#webpage\"},\"image\":\"https://data.birdeye.so/docs/images/Birdeye-Data-API-Docs.png\",\"dateModified\":\"2026-11-17T06:49:24.747Z\",\"keywords\":\"perp trade fills, fills history, trader fees, trade audit\",\"publisher\":{\"@id\":\"https://data.birdeye.so/#organization\"},\"isPartOf\":{\"@id\":\"https://data.birdeye.so/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Birdeye Data\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Birdeye Data\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills.md","siteName":"Birdeye Data","nav":{"global":null,"tabs":[{"tab":"Welcome","pages":[{"title":"Welcome","href":"/getting-started"}]},{"tab":"API Reference","icon":"gear-api","pages":[{"title":"API Reference","href":"/data-api/price-ohlcv"}]},{"tab":"Perps","icon":"chart-candlestick","groups":[{"group":"Perps Data API","root":{"title":"Perps Data API","hidden":false,"sidebarTitle":"Perps API","href":"/perps-api"},"pages":[{"group":"Perps Token","root":{"title":"Perps Token","hidden":false,"href":"/perps-api/perps-token/index"},"pages":[{"title":"Perps Token List","hidden":false,"openapi":"openapi/perps/openapi_perps_docs.json GET /perps/v1/token/list","href":"/perps-api/perps-token/get-perps-v1-token-list"},{"title":"Perps Token Overview","hidden":false,"openapi":"openapi/perps/openapi_perps_docs.json GET /perps/v1/token/overview","href":"/perps-api/perps-token/get-perps-v1-token-overview"},{"title":"Perps Token Open Positions","hidden":false,"openapi":"openapi/perps/openapi_perps_docs.json GET /perps/v1/token/open_positions","href":"/perps-api/perps-token/get-perps-v1-token-open-positions"},{"title":"Perps Token Liquidation Map","hidden":false,"openapi":"openapi/perps/openapi_perps_docs.json GET /perps/v1/token/liquidation_map","href":"/perps-api/perps-token/get-perps-v1-token-liquidation-map"}]},{"group":"Perps Wallet","root":{"title":"Perps Wallet API","hidden":false,"href":"/perps-api/perps-wallet/index"},"pages":[{"title":"Perps Wallet List","hidden":false,"openapi":"openapi/perps/openapi_perps_docs.json GET /perps/v1/wallet/list","href":"/perps-api/perps-wallet/get-perps-v1-wallet-list"},{"title":"Perps Wallet Overview","hidden":false,"openapi":"openapi/perps/openapi_perps_docs.json GET /perps/v1/wallet/overview","href":"/perps-api/perps-wallet/get-perps-v1-wallet-overview"},{"title":"Perps Wallet Open Positions","hidden":false,"openapi":"openapi/perps/openapi_perps_docs.json GET /perps/v1/wallet/open_positions","description":"List a wallet's open perp positions, with market, size, side, and entry price. Use it to monitor a trader's live exposure.","href":"/perps-api/perps-wallet/get-perps-v1-wallet-open-positions"},{"title":"Perps Wallet Trade Fills","hidden":false,"openapi":"openapi/perps/openapi_perps_docs.json POST /perps/v1/wallet/trade_fills","href":"/perps-api/perps-wallet/post-perps-v1-wallet-trade-fills"},{"title":"Perps Wallet Transfers","hidden":false,"openapi":"openapi/perps/openapi_perps_docs.json POST /perps/v1/wallet/transfers","description":"List a perp wallet's deposits and withdrawals. Use it to track how funds move in and out of a trading account.","href":"/perps-api/perps-wallet/post-perps-v1-wallet-transfers"}]}]}]},{"tab":"WebSockets","icon":"signal-stream","pages":[{"title":"WebSockets","href":"/websockets/subscribe-price-ohlcv"}]},{"tab":"Use Cases","icon":"briefcase","pages":[{"title":"Use Cases","href":"/use-cases/overview"}]},{"tab":"Agents","icon":"user-robot","pages":[{"title":"Agents","href":"/agents/overview"}]},{"tab":"Changelog","icon":"font-awesome-logo-full","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Perps Wallet Trade Fills - Birdeye Data","deploymentId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","buildId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-BGooz5Oc.js","dist-DbZ3bm7k.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-GKHRyhW5.js","utils-CXMoydtj.js","cloneDeep-Cl7CR73B.js","_Uint8Array-7sQhd3aE.js","isObject-FP1Yky1u.js","utils-ABJ_F6Yn.js","addUniqueKeysToSchema-B7v39GOQ.js","snippetPresets-CgibLHmh.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C2n3VqMC.js","isEqual-BKe3Q7nP.js","usePlaygroundInputsStore-Iji6acs6.js","shallow-Db9K5ulX.js","getApiPlaygroundDisplay-BGnJQBSj.js","CodeSnippet-DlQqWRja.js","CodeSnippets-JF3Bj6-U.js","Page-Ctn-BHcp.js","getPastedJson-B0pIrOza.js","icon-UPBYC1Wr.js","MethodPill-CoVRW5MG.js","DuplicateIcon-BuNnsqwg.js","createIcon-Cj9cJegl.js","DynamicMarkdown-C_R66tyH.js","SectionHeading-C6RB-y9f.js","axios-vUo_bRtp.js","Markdown-g2PbGssl.js","AssistantPageLink-BGnit25E.js"]}