The trades of the wallets GET /v3/traders/{traderId}/wallets lists for the trader, newest first. owner is this trader, with its tier on each wallet.
network and token narrow the list.
Order as in GET /v3/trades. Paged with cursor and limit (default 20, maximum 100). Follow nextCursor to read older rows.
Price
200 credits per started 20 rows of limit, plus 100 credits and one reveal for each distinct trader the page shows as an owner, on every call. A trader on two pages takes two reveals.
Answer
Credits
Reveals
limit 20 (the default), an empty page.
200
0
limit 20 (the default), the page lists trades.
300
1
limit 100 (the maximum), an empty page.
1,000
0
limit 100 (the maximum), the page lists trades.
1,100
1
404: no trader has this id.
200
0
Reveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 REVEAL_LIMIT_REACHED, or 403 PERMISSION_DENIED for a key on a free plan without reveals.
Limits
2,000 requests per minute from one address on this operation, beside the per-minute limit of the key.
A key with less than 200 credits left gets 402 QUOTA_EXCEEDED before any work.
The nextCursor of the previous page, sent back as it came. Leave it out for the first page. A cursor belongs to the query that produced it: sent with other parameters it answers 400 INVALID_ARGUMENT.
The cursor of the next page (c_…), or null on the last page. Treat it as opaque: send it back as cursor, never parse or build it.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FomoScan","colors":{"primary":"#2D6BF5","light":"#3B78FF","dark":"#2D6BF5"},"logo":{"light":"https://mintcdn.com/socialscan/HNyN-bTZ1IatgGfu/images/mark.png?fit=max\u0026auto=format\u0026n=HNyN-bTZ1IatgGfu\u0026q=85\u0026s=d477c368ad11635c9133ca701da2f527","dark":"https://mintcdn.com/socialscan/HNyN-bTZ1IatgGfu/images/mark.png?fit=max\u0026auto=format\u0026n=HNyN-bTZ1IatgGfu\u0026q=85\u0026s=d477c368ad11635c9133ca701da2f527"},"favicon":"https://mintcdn.com/socialscan/HNyN-bTZ1IatgGfu/images/mark.png?fit=max\u0026auto=format\u0026n=HNyN-bTZ1IatgGfu\u0026q=85\u0026s=d477c368ad11635c9133ca701da2f527","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python"]}},"appearance":{"default":"dark"},"background":{"color":{"dark":"#08090C"}},"navbar":{"links":[{"href":"https://partner.fomoscan.sh/login","label":"Log in"}],"primary":{"type":"button","label":"Get an API key","href":"https://partner.fomoscan.sh/signup"}},"footer":{"socials":{"website":"https://fomoscan.sh"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Partner portal","icon":"key","href":"https://partner.fomoscan.sh"},{"anchor":"OpenAPI spec","icon":"code","href":"https://api.fomoscan.sh/openapi.json"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"socialscan","hasAudioNarration":false,"actualSubdomain":"socialscan","customDomains":["docs.fomoscan.sh"],"gitSource":{"type":"github","owner":"funny-development-org","repo":"fomoscan-monorepo","deployBranch":"main","contentDirectory":"apps/web/docs","isPrivate":true,"mountPath":"","label":"","_id":"6aeb9444574a98914de25354"},"chroma":{"latestBuiltDeploymentHistoryId":"6aeba1c79a06eb92c7d964e2","collectionId":"ebaf5f04-b731-4f1f-be6c-a698b18b49c8","liveDeploymentHistoryId":"6aeba1c79a06eb92c7d964e2","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aeba1c79a06eb92c7d964e2","clientVersion":"0.0.4064","searchFilterCounts":[{"language":"default","tag":"API reference","count":56},{"language":"default","tag":"Endpoints","count":49},{"language":"default","tag":"Overview","count":26},{"language":"default","tag":"Core concepts","count":10},{"language":"default","tag":"Examples","count":10},{"language":"default","tag":"Identities","count":9},{"language":"default","tag":"WebSocket","count":7},{"language":"default","tag":"Pump","count":7},{"language":"default","tag":"Traders","count":7},{"language":"default","tag":"Get started","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"vite-origin","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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"v3/api-reference/trades/read-the-trades-of-a-traders-wallets","slug":"/v3/api-reference/trades/read-the-trades-of-a-traders-wallets","pageMetadata":{"title":"Read the trades of a trader's wallets","description":"The trades of the wallets `GET /v3/traders/{traderId}/wallets` lists for the trader, newest first. `owner` is this trader, with its tier on each wallet.\n\n- `network` and `token` narrow the list.\n- Order as in `GET /v3/trades`. Paged with `cursor` and `limit` (default 20, maximum 100). Follow `nextCursor` to read older rows.\n\n## Price\n\n**200 credits per started 20 rows of `limit`**, plus **100 credits and one reveal for each distinct trader the page shows as an owner**, on every call. A trader on two pages takes two reveals.\n\n| Answer | Credits | Reveals |\n| --- | --- | --- |\n| `limit` 20 (the default), an empty page. | 200 | 0 |\n| `limit` 20 (the default), the page lists trades. | 300 | 1 |\n| `limit` 100 (the maximum), an empty page. | 1,000 | 0 |\n| `limit` 100 (the maximum), the page lists trades. | 1,100 | 1 |\n| 404: no trader has this id. | 200 | 0 |\n\nReveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 `REVEAL_LIMIT_REACHED`, or 403 `PERMISSION_DENIED` for a key on a free plan without reveals.\n\n## Limits\n\n- 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key.\n- A key with less than 200 credits left gets 402 `QUOTA_EXCEEDED` before any work.","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/traders/{traderId}/trades","href":"/v3/api-reference/trades/read-the-trades-of-a-traders-wallets","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n h2: \"h2\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n table: \"table\",\n tbody: \"tbody\",\n td: \"td\",\n th: \"th\",\n thead: \"thead\",\n tr: \"tr\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"The trades of the wallets \", _jsx(_components.code, {\n children: \"GET /v3/traders/{traderId}/wallets\"\n }), \" lists for the trader, newest first. \", _jsx(_components.code, {\n children: \"owner\"\n }), \" is this trader, with its tier on each wallet.\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"network\"\n }), \" and \", _jsx(_components.code, {\n children: \"token\"\n }), \" narrow the list.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Order as in \", _jsx(_components.code, {\n children: \"GET /v3/trades\"\n }), \". Paged with \", _jsx(_components.code, {\n children: \"cursor\"\n }), \" and \", _jsx(_components.code, {\n children: \"limit\"\n }), \" (default 20, maximum 100). Follow \", _jsx(_components.code, {\n children: \"nextCursor\"\n }), \" to read older rows.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.h2, {\n children: \"Price\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsxs(_components.strong, {\n children: [\"200 credits per started 20 rows of \", _jsx(_components.code, {\n children: \"limit\"\n })]\n }), \", plus \", _jsx(_components.strong, {\n children: \"100 credits and one reveal for each distinct trader the page shows as an owner\"\n }), \", on every call. A trader on two pages takes two reveals.\"]\n }), \"\\n\", _jsxs(_components.table, {\n children: [_jsx(_components.thead, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.th, {\n children: \"Answer\"\n }), _jsx(_components.th, {\n children: \"Credits\"\n }), _jsx(_components.th, {\n children: \"Reveals\"\n })]\n })\n }), _jsxs(_components.tbody, {\n children: [_jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n children: [_jsx(_components.code, {\n children: \"limit\"\n }), \" 20 (the default), an empty page.\"]\n }), _jsx(_components.td, {\n children: \"200\"\n }), _jsx(_components.td, {\n children: \"0\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n children: [_jsx(_components.code, {\n children: \"limit\"\n }), \" 20 (the default), the page lists trades.\"]\n }), _jsx(_components.td, {\n children: \"300\"\n }), _jsx(_components.td, {\n children: \"1\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n children: [_jsx(_components.code, {\n children: \"limit\"\n }), \" 100 (the maximum), an empty page.\"]\n }), _jsx(_components.td, {\n children: \"1,000\"\n }), _jsx(_components.td, {\n children: \"0\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n children: [_jsx(_components.code, {\n children: \"limit\"\n }), \" 100 (the maximum), the page lists trades.\"]\n }), _jsx(_components.td, {\n children: \"1,100\"\n }), _jsx(_components.td, {\n children: \"1\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: \"404: no trader has this id.\"\n }), _jsx(_components.td, {\n children: \"200\"\n }), _jsx(_components.td, {\n children: \"0\"\n })]\n })]\n })]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Reveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 \", _jsx(_components.code, {\n children: \"REVEAL_LIMIT_REACHED\"\n }), \", or 403 \", _jsx(_components.code, {\n children: \"PERMISSION_DENIED\"\n }), \" for a key on a free plan without reveals.\"]\n }), \"\\n\", _jsx(_components.h2, {\n children: \"Limits\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"2,000 requests per minute from one address on this operation, beside the per-minute limit of the key.\"\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"A key with less than 200 credits left gets 402 \", _jsx(_components.code, {\n children: \"QUOTA_EXCEEDED\"\n }), \" before any work.\"]\n }), \"\\n\"]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Read the trades of a trader's wallets","description":"The trades of the wallets `GET /v3/traders/{traderId}/wallets` lists for the trader, newest first. `owner` is this trader, with its tier on each wallet.\n\n- `network` and `token` narrow the list.\n- Order as in `GET /v3/trades`. Paged with `cursor` and `limit` (default 20, maximum 100). Follow `nextCursor` to read older rows.\n\n## Price\n\n**200 credits per started 20 rows of `limit`**, plus **100 credits and one reveal for each distinct trader the page shows as an owner**, on every call. A trader on two pages takes two reveals.\n\n| Answer | Credits | Reveals |\n| --- | --- | --- |\n| `limit` 20 (the default), an empty page. | 200 | 0 |\n| `limit` 20 (the default), the page lists trades. | 300 | 1 |\n| `limit` 100 (the maximum), an empty page. | 1,000 | 0 |\n| `limit` 100 (the maximum), the page lists trades. | 1,100 | 1 |\n| 404: no trader has this id. | 200 | 0 |\n\nReveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 `REVEAL_LIMIT_REACHED`, or 403 `PERMISSION_DENIED` for a key on a free plan without reveals.\n\n## Limits\n\n- 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key.\n- A key with less than 200 credits left gets 402 `QUOTA_EXCEEDED` before any work.","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/traders/{traderId}/trades","href":"/v3/api-reference/trades/read-the-trades-of-a-traders-wallets","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"listTraderTrades","summary":"Read the trades of a trader's wallets","description":"The trades of the wallets `GET /v3/traders/{traderId}/wallets` lists for the trader, newest first. `owner` is this trader, with its tier on each wallet.\n\n- `network` and `token` narrow the list.\n- Order as in `GET /v3/trades`. Paged with `cursor` and `limit` (default 20, maximum 100). Follow `nextCursor` to read older rows.\n\n## Price\n\n**200 credits per started 20 rows of `limit`**, plus **100 credits and one reveal for each distinct trader the page shows as an owner**, on every call. A trader on two pages takes two reveals.\n\n| Answer | Credits | Reveals |\n| --- | --- | --- |\n| `limit` 20 (the default), an empty page. | 200 | 0 |\n| `limit` 20 (the default), the page lists trades. | 300 | 1 |\n| `limit` 100 (the maximum), an empty page. | 1,000 | 0 |\n| `limit` 100 (the maximum), the page lists trades. | 1,100 | 1 |\n| 404: no trader has this id. | 200 | 0 |\n\nReveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 `REVEAL_LIMIT_REACHED`, or 403 `PERMISSION_DENIED` for a key on a free plan without reveals.\n\n## Limits\n\n- 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key.\n- A key with less than 200 credits left gets 402 `QUOTA_EXCEEDED` before any work.","tags":["Trades"],"x-operation":23,"parameters":["623146bf-d65a-4e28-9fde-9b529a84a6e6","9b6f853b-11ac-48d3-8ee6-81b3de5d1c36","2bf88843-32e1-4677-9e30-bf20738f81f1","55cb8408-d084-4529-9d17-d8f5a766f296","6d7a7ae9-ce53-45e4-8ac4-20489c5ee26d"],"responses":{"200":"fa64a122-906b-4c9c-80b4-78a47af4513d","400":"70d9383e-3847-43e3-b0fb-b048549a8fcf","401":"b6289687-8507-4755-b8f1-284e72ffc05d","402":"b8071344-478b-4fd6-b418-73a29c4405dc","403":"14e85cd5-5adc-446f-93c3-460ebe28a653","404":"56965451-d7df-4864-8f0d-a2d2192dc510","429":"d7375bf9-877a-41ce-bc22-d34bda23ec6e","500":"8d8c4943-dc6d-46f3-80dd-e91a33ffbcbc","503":"d6a46efe-7ae1-4610-a13e-cde9cecae012"},"method":"get","type":"path","servers":["5fe32091-bca0-4091-894b-0b0476baa441"],"security":["1dae2ee9-4ade-434c-a812-454ff298e096","cc08a9cd-c1f8-4037-b1f0-a8a921734bd0"],"path":"/v3/traders/{traderId}/trades","baseUrlOptions":["https://api.fomoscan.sh"],"title":"Read the trades of a trader's wallets","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"623146bf-d65a-4e28-9fde-9b529a84a6e6":{"name":"traderId","in":"path","description":"A trader id: `tdr_` and 26 characters. `GET /v3/traders/lookup` finds it by handle.","required":true,"schema":{"type":"string","pattern":"^tdr_[0-7][0-9a-hjkmnp-tv-z]{25}$","isRequired":true,"description":"A trader id: `tdr_` and 26 characters. `GET /v3/traders/lookup` finds it by handle.","uniqueKey":"","typeLabel":"string"}},"9b6f853b-11ac-48d3-8ee6-81b3de5d1c36":{"name":"network","in":"query","description":"Only trades on this network. Leave it out for every network.","required":false,"schema":{"type":"string","enum":["solana","ethereum","base","bsc","arbitrum","optimism","polygon","robinhood","hyperevm","monad","arc","xlayer","ink","hyperliquid"],"isRequired":false,"description":"Only trades on this network. Leave it out for every network.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"2bf88843-32e1-4677-9e30-bf20738f81f1":{"name":"token","in":"query","description":"Only trades in this token: `tok_\u003cnetwork>_\u003caddress>`.","required":false,"schema":{"type":"string","minLength":5,"maxLength":200,"isRequired":false,"description":"Only trades in this token: `tok_\u003cnetwork>_\u003caddress>`.","uniqueKey":"","typeLabel":"string"}},"55cb8408-d084-4529-9d17-d8f5a766f296":{"name":"cursor","in":"query","description":"The `nextCursor` of the previous page, sent back as it came. Leave it out for the first page. A cursor belongs to the query that produced it: sent with other parameters it answers 400 `INVALID_ARGUMENT`.","required":false,"schema":{"type":"string","minLength":3,"maxLength":1024,"isRequired":false,"description":"The `nextCursor` of the previous page, sent back as it came. Leave it out for the first page. A cursor belongs to the query that produced it: sent with other parameters it answers 400 `INVALID_ARGUMENT`.","uniqueKey":"","typeLabel":"string"}},"6d7a7ae9-ce53-45e4-8ac4-20489c5ee26d":{"name":"limit","in":"query","description":"Rows per page, 1 to 100. 20 when left out.","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100,"isRequired":false,"description":"Rows per page, 1 to 100. 20 when left out.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"fa64a122-906b-4c9c-80b4-78a47af4513d":{"description":"OK","headers":{"X-Request-Id":{"description":"The id of this request, as in our logs.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests per minute allowed for the key.","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Seconds until the current minute ends.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","const":"trade","description":"The kind of object, `trade` here, and the only field to switch on. Skip objects whose kind you do not know.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].kind","typeLabel":"string"},"id":{"type":"string","description":"Our id of the object, `trd_` and 26 lowercase base32 characters. Store it: it stays the same across calls and never holds a platform's own id.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].id","typeLabel":"string"},"canonical":{"type":"object","properties":{"network":{"type":"string","enum":["solana","ethereum","base","bsc","arbitrum","optimism","polygon","robinhood","hyperevm","monad","arc","xlayer","ink","hyperliquid"],"description":"The network of the transaction.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.network","typeLabel":"enum\u003cstring>"},"txHash":{"type":"string","description":"The transaction hash (the signature on Solana).","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.txHash","typeLabel":"string"},"blockNumber":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"The block, or the slot on Solana.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.blockNumber","typeLabel":"integer"},"executedAt":{"oneOf":[{"type":"string","description":"The block time of the transaction.","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.executedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"The block time of the transaction.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.executedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.executedAt","typeLabel":"string\u003cdate-time> | null"},"wallet":{"type":"string","description":"The `wal_` id of the wallet that traded.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.wallet","typeLabel":"string"},"side":{"type":"string","enum":["buy","sell","swap"],"description":"`buy` and `sell` trade `token` against `quoteToken`; `swap` trades two tokens.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.side","typeLabel":"enum\u003cstring>"},"token":{"type":"string","description":"The `tok_` id of the token traded.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.token","typeLabel":"string"},"quantity":{"type":"object","properties":{"value":{"type":"string","pattern":"^(0|-?[1-9]\\d*)$","description":"An integer in base units, as a string, and negative below zero. Read it with a decimal or big integer type; a float loses digits.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quantity.value","typeLabel":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36,"description":"The power of ten between base units and one whole unit: `value` ÷ 10^`decimals`.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quantity.decimals","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"description":"`USD`, or the token id (`tok_\u003cnetwork>_\u003caddress>`) of a token quantity.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quantity.currency","typeLabel":"string"},"priceAsOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$","description":"The time of the price we converted the value with. Absent when no price was used.","uniqueKey":"\\items.items.[INDEX].canonical.quantity.priceAsOf","typeLabel":"string\u003cdate-time>"}},"required":["value","decimals","currency"],"description":"How much of `token` moved, in that token.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quantity","typeLabel":"object"},"quoteToken":{"oneOf":[{"description":"The `tok_` id of the token paid or received for it.","type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quoteToken.oneOf.0","typeLabel":"string"},{"description":"The `tok_` id of the token paid or received for it.","type":"null","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quoteToken.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quoteToken","typeLabel":"string | null"},"quoteQuantity":{"oneOf":[{"type":"object","description":"How much of `quoteToken` moved, in that token.","required":["value","decimals","currency"],"properties":{"value":{"type":"string","pattern":"^(0|-?[1-9]\\d*)$","description":"An integer in base units, as a string, and negative below zero. Read it with a decimal or big integer type; a float loses digits.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quoteQuantity.oneOf.0.value","typeLabel":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36,"description":"The power of ten between base units and one whole unit: `value` ÷ 10^`decimals`.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quoteQuantity.oneOf.0.decimals","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"description":"`USD`, or the token id (`tok_\u003cnetwork>_\u003caddress>`) of a token quantity.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quoteQuantity.oneOf.0.currency","typeLabel":"string"},"priceAsOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$","description":"The time of the price we converted the value with. Absent when no price was used.","uniqueKey":"\\items.items.[INDEX].canonical.quoteQuantity.oneOf.0.priceAsOf","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quoteQuantity.oneOf.0","typeLabel":"object"},{"type":"null","description":"How much of `quoteToken` moved, in that token.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quoteQuantity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.quoteQuantity","typeLabel":"object | null"},"platform":{"oneOf":[{"type":"string","description":"The platform that routed the trade, when we can tell.","enum":["fomo","pump","hyperliquid","markets","polymarket","legend","risex"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.platform.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The platform that routed the trade, when we can tell.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.platform.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.platform","typeLabel":"enum\u003cstring> | null"},"verification":{"type":"string","enum":["chain","relay"],"description":"`chain`: we read it from the chain. `relay`: a relay reported it and the chain has not confirmed it yet.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.verification","typeLabel":"enum\u003cstring>"},"owner":{"oneOf":[{"type":"object","description":"The trader the operation shows as the owner of `wallet`. `null` on `GET /v3/wallets/{family}/{address}/trades`.","required":["trader","handle","tier"],"properties":{"trader":{"type":"string","description":"The `tdr_` id of the owner.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.owner.oneOf.0.trader","typeLabel":"string"},"handle":{"oneOf":[{"description":"The owner's `canonical.display.handle`.","type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.owner.oneOf.0.handle.oneOf.0","typeLabel":"string"},{"description":"The owner's `canonical.display.handle`.","type":"null","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.owner.oneOf.0.handle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.owner.oneOf.0.handle","typeLabel":"string | null"},"tier":{"type":"string","enum":["proven","account","partial","weak","unverified"],"description":"How sure we are that the trader owns the wallet, strongest first: `proven` (an on-chain proof), `account` (the wallet is the key of the platform account), `partial` (a one-sided proof), `weak` (an ambiguous or imported link), `unverified`.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.owner.oneOf.0.tier","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.owner.oneOf.0","typeLabel":"object"},{"type":"null","description":"The trader the operation shows as the owner of `wallet`. `null` on `GET /v3/wallets/{family}/{address}/trades`.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.owner.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical.owner","typeLabel":"object | null"}},"required":["network","txHash","blockNumber","executedAt","wallet","side","token","quantity","quoteToken","quoteQuantity","platform","verification","owner"],"description":"Fields that mean the same on every platform.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].canonical","typeLabel":"object"},"sources":{"type":"object","propertyNames":{"type":"string","enum":["fomo","pump","hyperliquid","markets","polymarket","legend","risex"]},"additionalProperties":{"type":"object","properties":{},"uniqueKey":"\\items.items.[INDEX].sources.additionalProperties","typeLabel":"object"},"description":"Capability blocks keyed by platform. A platform key is absent when the object has no side on that platform. A block is absent when the platform cannot provide it (`GET /v3/capabilities` lists which can) or we hold no reading of it yet. A field is `null` when the platform left it empty at `observedAt` or never fills it (`unfilled` in `GET /v3/capabilities`). Skip platform keys and blocks you do not know.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].sources","typeLabel":"object"}},"required":["kind","id","canonical","sources"],"description":"One on-chain swap by one wallet. Quantities only; prices come from the token.","uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"description":"The rows of this page, in the order the operation states.","isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"hasMore":{"type":"boolean","description":"`true` when another page follows this one.","isRequired":true,"uniqueKey":"hasMore","typeLabel":"boolean"},"nextCursor":{"oneOf":[{"description":"The cursor of the next page (`c_…`), or `null` on the last page. Treat it as opaque: send it back as `cursor`, never parse or build it.","type":"string","isRequired":true,"uniqueKey":"nextCursor.oneOf.0","typeLabel":"string"},{"description":"The cursor of the next page (`c_…`), or `null` on the last page. Treat it as opaque: send it back as `cursor`, never parse or build it.","type":"null","isRequired":true,"uniqueKey":"nextCursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nextCursor","typeLabel":"string | null"}},"required":["items","hasMore","nextCursor"],"description":"One page of a list. Pass `nextCursor` back as `cursor` for the next page.","uniqueKey":"","typeLabel":"object"},"example":{"items":[{"kind":"trade","id":"trd_01jbsta8h2ecsr8h2nank6cxvq","canonical":{"network":"solana","txHash":"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW","blockNumber":371904117,"executedAt":"2026-11-01T08:57:12.000Z","wallet":"wal_svm_9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM","side":"buy","token":"tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263","quantity":{"value":"412500000000","decimals":5,"currency":"tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"},"quoteToken":"tok_solana_So11111111111111111111111111111111111111112","quoteQuantity":{"value":"326814220","decimals":9,"currency":"tok_solana_So11111111111111111111111111111111111111112"},"platform":"fomo","verification":"chain","owner":{"trader":"tdr_01jbst8pvcfp79y0938nkrkayd","handle":"nightowl","tier":"proven"}},"sources":{}},{"kind":"trade","id":"trd_01jbstacskeh28anb6csvqf248","canonical":{"network":"solana","txHash":"3nTq8bVf9Lw2Hk7Yd4Rx6Cm1Pz5Js8Ga2Ue9Wo4Bt7Nc3Fy6Qh1Dk5Mv8Xr2Lp9Sg4Ja7Ze3Tb6Wn1Ku5Yc8Hf2Vd","blockNumber":371903650,"executedAt":"2026-11-01T08:54:03.000Z","wallet":"wal_svm_9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM","side":"sell","token":"tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263","quantity":{"value":"150000000000","decimals":5,"currency":"tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"},"quoteToken":"tok_solana_So11111111111111111111111111111111111111112","quoteQuantity":{"value":"121480930","decimals":9,"currency":"tok_solana_So11111111111111111111111111111111111111112"},"platform":"fomo","verification":"chain","owner":{"trader":"tdr_01jbst8pvcfp79y0938nkrkayd","handle":"nightowl","tier":"proven"}},"sources":{}}],"hasMore":true,"nextCursor":"c_eyJxIjoiazNKOXhRMm1aN2FCIiwidiI6eyJzIjoiMjAyNi0xMS0wMVQwODo0MTowMi45MTdaIiwiaSI6IjAxOTJmM2E1LTIyMjItNzMzMy04NDQ0LTU1NTU2NjY2Nzc3NyJ9fQ"},"examples":{"Example":{"title":"Example","value":{"items":[{"kind":"trade","id":"trd_01jbsta8h2ecsr8h2nank6cxvq","canonical":{"network":"solana","txHash":"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW","blockNumber":371904117,"executedAt":"2026-11-01T08:57:12.000Z","wallet":"wal_svm_9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM","side":"buy","token":"tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263","quantity":{"value":"412500000000","decimals":5,"currency":"tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"},"quoteToken":"tok_solana_So11111111111111111111111111111111111111112","quoteQuantity":{"value":"326814220","decimals":9,"currency":"tok_solana_So11111111111111111111111111111111111111112"},"platform":"fomo","verification":"chain","owner":{"trader":"tdr_01jbst8pvcfp79y0938nkrkayd","handle":"nightowl","tier":"proven"}},"sources":{}},{"kind":"trade","id":"trd_01jbstacskeh28anb6csvqf248","canonical":{"network":"solana","txHash":"3nTq8bVf9Lw2Hk7Yd4Rx6Cm1Pz5Js8Ga2Ue9Wo4Bt7Nc3Fy6Qh1Dk5Mv8Xr2Lp9Sg4Ja7Ze3Tb6Wn1Ku5Yc8Hf2Vd","blockNumber":371903650,"executedAt":"2026-11-01T08:54:03.000Z","wallet":"wal_svm_9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM","side":"sell","token":"tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263","quantity":{"value":"150000000000","decimals":5,"currency":"tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"},"quoteToken":"tok_solana_So11111111111111111111111111111111111111112","quoteQuantity":{"value":"121480930","decimals":9,"currency":"tok_solana_So11111111111111111111111111111111111111112"},"platform":"fomo","verification":"chain","owner":{"trader":"tdr_01jbst8pvcfp79y0938nkrkayd","handle":"nightowl","tier":"proven"}},"sources":{}}],"hasMore":true,"nextCursor":"c_eyJxIjoiazNKOXhRMm1aN2FCIiwidiI6eyJzIjoiMjAyNi0xMS0wMVQwODo0MTowMi45MTdaIiwiaSI6IjAxOTJmM2E1LTIyMjItNzMzMy04NDQ0LTU1NTU2NjY2Nzc3NyJ9fQ"}}},"exampleType":"examples"}},"exampleType":"examples"},"70d9383e-3847-43e3-b0fb-b048549a8fcf":{"description":"`INVALID_ARGUMENT`: a parameter, an id, a cursor or the body is malformed, or the operation does not take it.\n\n- `token` is not a token id (`tok_\u003cnetwork>_\u003caddress>`).","headers":{"X-Request-Id":{"description":"The id of this request, as in our logs.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request","authentication","quota","permission","rate_limit","internal","overloaded"],"description":"The group of the error. Each `code` belongs to one type.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","QUOTA_EXCEEDED","REVEAL_LIMIT_REACHED","PERMISSION_DENIED","PLAN_REQUIRED","NOT_FOUND","RATE_LIMITED","INTERNAL","OVERLOADED"],"description":"What went wrong, from a closed list. Act on this field.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A sentence for people. It can change; never parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","description":"The id of the request, equal to `X-Request-Id`. Quote it when you write to us.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["type","code","message","requestId"],"description":"The error.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"The body of every error answer.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request","code":"INVALID_ARGUMENT","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b6289687-8507-4755-b8f1-284e72ffc05d":{"description":"`UNAUTHENTICATED`: no key, or the key is unknown, revoked or expired.","headers":{"X-Request-Id":{"description":"The id of this request, as in our logs.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request","authentication","quota","permission","rate_limit","internal","overloaded"],"description":"The group of the error. Each `code` belongs to one type.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","QUOTA_EXCEEDED","REVEAL_LIMIT_REACHED","PERMISSION_DENIED","PLAN_REQUIRED","NOT_FOUND","RATE_LIMITED","INTERNAL","OVERLOADED"],"description":"What went wrong, from a closed list. Act on this field.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A sentence for people. It can change; never parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","description":"The id of the request, equal to `X-Request-Id`. Quote it when you write to us.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["type","code","message","requestId"],"description":"The error.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"The body of every error answer.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request","code":"INVALID_ARGUMENT","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b8071344-478b-4fd6-b418-73a29c4405dc":{"description":"`QUOTA_EXCEEDED`: the credit balance cannot pay for the call.\n\n`REVEAL_LIMIT_REACHED`: the answer needs a reveal and the key has used every reveal this month. Nothing is charged.","headers":{"X-Request-Id":{"description":"The id of this request, as in our logs.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request","authentication","quota","permission","rate_limit","internal","overloaded"],"description":"The group of the error. Each `code` belongs to one type.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","QUOTA_EXCEEDED","REVEAL_LIMIT_REACHED","PERMISSION_DENIED","PLAN_REQUIRED","NOT_FOUND","RATE_LIMITED","INTERNAL","OVERLOADED"],"description":"What went wrong, from a closed list. Act on this field.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A sentence for people. It can change; never parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","description":"The id of the request, equal to `X-Request-Id`. Quote it when you write to us.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["type","code","message","requestId"],"description":"The error.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"The body of every error answer.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request","code":"INVALID_ARGUMENT","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"14e85cd5-5adc-446f-93c3-460ebe28a653":{"description":"`PERMISSION_DENIED`: the key may not make this call.\n\n`PERMISSION_DENIED` also when a key on a free plan without reveals asks for an answer that needs one. Nothing is charged.","headers":{"X-Request-Id":{"description":"The id of this request, as in our logs.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request","authentication","quota","permission","rate_limit","internal","overloaded"],"description":"The group of the error. Each `code` belongs to one type.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","QUOTA_EXCEEDED","REVEAL_LIMIT_REACHED","PERMISSION_DENIED","PLAN_REQUIRED","NOT_FOUND","RATE_LIMITED","INTERNAL","OVERLOADED"],"description":"What went wrong, from a closed list. Act on this field.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A sentence for people. It can change; never parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","description":"The id of the request, equal to `X-Request-Id`. Quote it when you write to us.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["type","code","message","requestId"],"description":"The error.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"The body of every error answer.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request","code":"INVALID_ARGUMENT","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"56965451-d7df-4864-8f0d-a2d2192dc510":{"description":"`NOT_FOUND`. No trader has this id, merges included.","headers":{"X-Request-Id":{"description":"The id of this request, as in our logs.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request","authentication","quota","permission","rate_limit","internal","overloaded"],"description":"The group of the error. Each `code` belongs to one type.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","QUOTA_EXCEEDED","REVEAL_LIMIT_REACHED","PERMISSION_DENIED","PLAN_REQUIRED","NOT_FOUND","RATE_LIMITED","INTERNAL","OVERLOADED"],"description":"What went wrong, from a closed list. Act on this field.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A sentence for people. It can change; never parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","description":"The id of the request, equal to `X-Request-Id`. Quote it when you write to us.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["type","code","message","requestId"],"description":"The error.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"The body of every error answer.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request","code":"INVALID_ARGUMENT","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d7375bf9-877a-41ce-bc22-d34bda23ec6e":{"description":"`RATE_LIMITED`: too many requests. Retry after the seconds in `Retry-After`.","headers":{"X-Request-Id":{"description":"The id of this request, as in our logs.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request","authentication","quota","permission","rate_limit","internal","overloaded"],"description":"The group of the error. Each `code` belongs to one type.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","QUOTA_EXCEEDED","REVEAL_LIMIT_REACHED","PERMISSION_DENIED","PLAN_REQUIRED","NOT_FOUND","RATE_LIMITED","INTERNAL","OVERLOADED"],"description":"What went wrong, from a closed list. Act on this field.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A sentence for people. It can change; never parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","description":"The id of the request, equal to `X-Request-Id`. Quote it when you write to us.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["type","code","message","requestId"],"description":"The error.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"The body of every error answer.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request","code":"INVALID_ARGUMENT","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"8d8c4943-dc6d-46f3-80dd-e91a33ffbcbc":{"description":"`INTERNAL`: the call failed on our side.","headers":{"X-Request-Id":{"description":"The id of this request, as in our logs.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request","authentication","quota","permission","rate_limit","internal","overloaded"],"description":"The group of the error. Each `code` belongs to one type.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","QUOTA_EXCEEDED","REVEAL_LIMIT_REACHED","PERMISSION_DENIED","PLAN_REQUIRED","NOT_FOUND","RATE_LIMITED","INTERNAL","OVERLOADED"],"description":"What went wrong, from a closed list. Act on this field.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A sentence for people. It can change; never parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","description":"The id of the request, equal to `X-Request-Id`. Quote it when you write to us.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["type","code","message","requestId"],"description":"The error.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"The body of every error answer.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request","code":"INVALID_ARGUMENT","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d6a46efe-7ae1-4610-a13e-cde9cecae012":{"description":"`OVERLOADED`: the API holds too many requests at once. Retry after the seconds in `Retry-After`.","headers":{"X-Request-Id":{"description":"The id of this request, as in our logs.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request","authentication","quota","permission","rate_limit","internal","overloaded"],"description":"The group of the error. Each `code` belongs to one type.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","QUOTA_EXCEEDED","REVEAL_LIMIT_REACHED","PERMISSION_DENIED","PLAN_REQUIRED","NOT_FOUND","RATE_LIMITED","INTERNAL","OVERLOADED"],"description":"What went wrong, from a closed list. Act on this field.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A sentence for people. It can change; never parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","description":"The id of the request, equal to `X-Request-Id`. Quote it when you write to us.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["type","code","message","requestId"],"description":"The error.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"The body of every error answer.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request","code":"INVALID_ARGUMENT","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"1dae2ee9-4ade-434c-a812-454ff298e096":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}},"cc08a9cd-c1f8-4037-b1f0-a8a921734bd0":{"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Api-Key","scopes":[],"schemeName":"apiKeyHeader"}}},"servers":{"5fe32091-bca0-4091-894b-0b0476baa441":{"url":"https://api.fomoscan.sh","description":"The API host"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","scopes":[],"schemeName":"apiKeyHeader"},"schema":{"title":"X-Api-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyHeader","name":"X-Api-Key"}],"title":"apiKeyHeader"}]},"originalFileLocation":"https://api.fomoscan.sh/v3/openapi.json"},"subdomain":"socialscan","siteName":"FomoScan","title":"Read the trades of a trader's wallets - FomoScan","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference/identities/read-a-wallet-free-stored-profile","matchLevel":2},"v3":{"href":"/v3/api-reference/trades/read-the-trades-of-a-traders-wallets","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T20:47:34.197Z","originalFileLocation":"v3/api-reference/trades/read-the-trades-of-a-traders-wallets.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=\"dark\"}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=\"The trades of the wallets GET /v3/traders/{traderId}/wallets lists for the trader, newest first. owner is this trader, with its tier on each wallet. - network and token narrow the list. - Order as in GET /v3/trades. Paged with cursor and limit (default 20, maximum 100). Follow nextCursor to read older rows. ## Price 200 credits per started 20 rows of limit, plus 100 credits and one reveal for each distinct trader the page shows as an owner, on every call. A trader on two pages takes two reveals. | Answer | Credits | Reveals | | --- | --- | --- | | limit 20 (the default), an empty page. | 200 | 0 | | limit 20 (the default), the page lists trades. | 300 | 1 | | limit 100 (the maximum), an empty page. | 1,000 | 0 | | limit 100 (the maximum), the page lists trades. | 1,100 | 1 | | 404: no trader has this id. | 200 | 0 | Reveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 REVEAL_LIMIT_REACHED, or 403 PERMISSION_DENIED for a key on a free plan without reveals. ## Limits - 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key. - A key with less than 200 credits left gets 402 QUOTA_EXCEEDED before any work.\">\u003cmeta data-mint-head name=\"application-name\" content=\"FomoScan\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/socialscan/Akelxu7vD__0Z47A/_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=\"/mintlify-assets/_mintlify/favicons/socialscan/Akelxu7vD__0Z47A/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/socialscan/Akelxu7vD__0Z47A/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/socialscan/Akelxu7vD__0Z47A/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/socialscan/Akelxu7vD__0Z47A/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/socialscan/Akelxu7vD__0Z47A/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/socialscan/Akelxu7vD__0Z47A/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/socialscan/Akelxu7vD__0Z47A/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/socialscan/Akelxu7vD__0Z47A/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Read the trades of a trader\u0026#x27;s wallets - FomoScan\">\u003cmeta data-mint-head property=\"og:description\" content=\"The trades of the wallets GET /v3/traders/{traderId}/wallets lists for the trader, newest first. owner is this trader, with its tier on each wallet. - network and token narrow the list. - Order as in GET /v3/trades. Paged with cursor and limit (default 20, maximum 100). Follow nextCursor to read older rows. ## Price 200 credits per started 20 rows of limit, plus 100 credits and one reveal for each distinct trader the page shows as an owner, on every call. A trader on two pages takes two reveals. | Answer | Credits | Reveals | | --- | --- | --- | | limit 20 (the default), an empty page. | 200 | 0 | | limit 20 (the default), the page lists trades. | 300 | 1 | | limit 100 (the maximum), an empty page. | 1,000 | 0 | | limit 100 (the maximum), the page lists trades. | 1,100 | 1 | | 404: no trader has this id. | 200 | 0 | Reveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 REVEAL_LIMIT_REACHED, or 403 PERMISSION_DENIED for a key on a free plan without reveals. ## Limits - 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key. - A key with less than 200 credits left gets 402 QUOTA_EXCEEDED before any work.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FomoScan\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-trades-of-a-traders-wallets\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://socialscan.mintlify.app/_mintlify/api/og/v2?division=Trades\u0026amp;title=Read+the+trades+of+a+trader%27s+wallets\u0026amp;description=The+trades+of+the+wallets+%60GET+%2Fv3%2Ftraders%2F%7BtraderId%7D%2Fwallets%60+lists+for+the+trader%2C+newest+first.+%60owner%60+is+this+trader%2C+with+its+tier+on+each+wallet.%0A%0A-+%60net\u0026amp;theme=eee421e92d714c8c3b4eb52f\u0026amp;signature=37c420aa106feb7d8e2707ccad775971db66f58f6764589d84416b481c18e295\">\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=\"Read the trades of a trader\u0026#x27;s wallets - FomoScan\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The trades of the wallets GET /v3/traders/{traderId}/wallets lists for the trader, newest first. owner is this trader, with its tier on each wallet. - network and token narrow the list. - Order as in GET /v3/trades. Paged with cursor and limit (default 20, maximum 100). Follow nextCursor to read older rows. ## Price 200 credits per started 20 rows of limit, plus 100 credits and one reveal for each distinct trader the page shows as an owner, on every call. A trader on two pages takes two reveals. | Answer | Credits | Reveals | | --- | --- | --- | | limit 20 (the default), an empty page. | 200 | 0 | | limit 20 (the default), the page lists trades. | 300 | 1 | | limit 100 (the maximum), an empty page. | 1,000 | 0 | | limit 100 (the maximum), the page lists trades. | 1,100 | 1 | | 404: no trader has this id. | 200 | 0 | Reveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 REVEAL_LIMIT_REACHED, or 403 PERMISSION_DENIED for a key on a free plan without reveals. ## Limits - 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key. - A key with less than 200 credits left gets 402 QUOTA_EXCEEDED before any work.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://socialscan.mintlify.app/_mintlify/api/og/v2?division=Trades\u0026amp;title=Read+the+trades+of+a+trader%27s+wallets\u0026amp;description=The+trades+of+the+wallets+%60GET+%2Fv3%2Ftraders%2F%7BtraderId%7D%2Fwallets%60+lists+for+the+trader%2C+newest+first.+%60owner%60+is+this+trader%2C+with+its+tier+on+each+wallet.%0A%0A-+%60net\u0026amp;theme=eee421e92d714c8c3b4eb52f\u0026amp;signature=37c420aa106feb7d8e2707ccad775971db66f58f6764589d84416b481c18e295\">\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=\"/mintlify-assets/_mintlify/favicons/socialscan/Akelxu7vD__0Z47A/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FomoScan\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2D6BF5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-trades-of-a-traders-wallets\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v3/api-reference/trades/read-the-trades-of-a-traders-wallets.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fomoscan.sh/#organization\",\"name\":\"FomoScan\",\"url\":\"https://docs.fomoscan.sh\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/socialscan/HNyN-bTZ1IatgGfu/images/mark.png?fit=max\u0026auto=format\u0026n=HNyN-bTZ1IatgGfu\u0026q=85\u0026s=d477c368ad11635c9133ca701da2f527\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fomoscan.sh#website\",\"name\":\"FomoScan\",\"url\":\"https://docs.fomoscan.sh\",\"publisher\":{\"@id\":\"https://docs.fomoscan.sh/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-trades-of-a-traders-wallets#webpage\",\"url\":\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-trades-of-a-traders-wallets\",\"name\":\"Read the trades of a trader's wallets\",\"description\":\"The trades of the wallets GET /v3/traders/{traderId}/wallets lists for the trader, newest first. owner is this trader, with its tier on each wallet. - network and token narrow the list. - Order as in GET /v3/trades. Paged with cursor and limit (default 20, maximum 100). Follow nextCursor to read older rows. ## Price 200 credits per started 20 rows of limit, plus 100 credits and one reveal for each distinct trader the page shows as an owner, on every call. A trader on two pages takes two reveals. | Answer | Credits | Reveals | | --- | --- | --- | | limit 20 (the default), an empty page. | 200 | 0 | | limit 20 (the default), the page lists trades. | 300 | 1 | | limit 100 (the maximum), an empty page. | 1,000 | 0 | | limit 100 (the maximum), the page lists trades. | 1,100 | 1 | | 404: no trader has this id. | 200 | 0 | Reveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 REVEAL_LIMIT_REACHED, or 403 PERMISSION_DENIED for a key on a free plan without reveals. ## Limits - 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key. - A key with less than 200 credits left gets 402 QUOTA_EXCEEDED before any work.\",\"dateModified\":\"2026-11-04T20:47:34.197Z\",\"isPartOf\":{\"@id\":\"https://docs.fomoscan.sh#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-trades-of-a-traders-wallets#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-trades-of-a-traders-wallets#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.fomoscan.sh/v3/api-reference/traders/read-one-trader\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Trades\",\"item\":\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-newest-trades-of-the-traders-we-mapped\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Read the trades of a trader's wallets\",\"item\":\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-trades-of-a-traders-wallets\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-trades-of-a-traders-wallets#apireference\",\"headline\":\"Read the trades of a trader's wallets\",\"name\":\"Read the trades of a trader's wallets\",\"description\":\"The trades of the wallets GET /v3/traders/{traderId}/wallets lists for the trader, newest first. owner is this trader, with its tier on each wallet. - network and token narrow the list. - Order as in GET /v3/trades. Paged with cursor and limit (default 20, maximum 100). Follow nextCursor to read older rows. ## Price 200 credits per started 20 rows of limit, plus 100 credits and one reveal for each distinct trader the page shows as an owner, on every call. A trader on two pages takes two reveals. | Answer | Credits | Reveals | | --- | --- | --- | | limit 20 (the default), an empty page. | 200 | 0 | | limit 20 (the default), the page lists trades. | 300 | 1 | | limit 100 (the maximum), an empty page. | 1,000 | 0 | | limit 100 (the maximum), the page lists trades. | 1,100 | 1 | | 404: no trader has this id. | 200 | 0 | Reveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 REVEAL_LIMIT_REACHED, or 403 PERMISSION_DENIED for a key on a free plan without reveals. ## Limits - 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key. - A key with less than 200 credits left gets 402 QUOTA_EXCEEDED before any work.\",\"url\":\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-trades-of-a-traders-wallets\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fomoscan.sh/v3/api-reference/trades/read-the-trades-of-a-traders-wallets#webpage\"},\"dateModified\":\"2026-11-04T20:47:34.197Z\",\"publisher\":{\"@id\":\"https://docs.fomoscan.sh/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fomoscan.sh#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FomoScan\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"FomoScan","nav":{"global":{"anchors":[{"anchor":"Partner portal","icon":"key","href":"https://partner.fomoscan.sh"},{"anchor":"OpenAPI spec","icon":"code","href":"https://api.fomoscan.sh/openapi.json"}]},"versions":[{"version":"v2","default":true,"pages":[{"title":"v2","href":"/api-reference/identities/read-a-wallet-free-stored-profile"}]},{"version":"v3","tag":"New","tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/v3"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","href":"/v3/api-reference/introduction"},{"title":"Traders, wallets and PnL","href":"/v3/guides/traders"},{"title":"Posts","href":"/v3/guides/posts"},{"title":"Leaderboards and rankings","href":"/v3/guides/boards"}]},{"group":"Endpoints","pages":[{"group":"Traders","pages":[{"title":"Read one trader","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/traders/{traderId}","href":"/v3/api-reference/traders/read-one-trader"},{"title":"Find traders by handle","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/traders/lookup","href":"/v3/api-reference/traders/find-traders-by-handle"},{"title":"List the wallets of a trader","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/traders/{traderId}/wallets","href":"/v3/api-reference/traders/list-the-wallets-of-a-trader"},{"title":"Read a trader's PnL across whole wallets","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/traders/{traderId}/pnl","href":"/v3/api-reference/traders/read-a-traders-pnl-across-whole-wallets"},{"title":"Read the PnL of up to 100 traders","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json post /v3/traders/pnl","href":"/v3/api-reference/traders/read-the-pnl-of-up-to-100-traders"},{"title":"List the traders who follow a trader","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/traders/{traderId}/followers","href":"/v3/api-reference/traders/list-the-traders-who-follow-a-trader"},{"title":"List the traders a trader follows","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/traders/{traderId}/following","href":"/v3/api-reference/traders/list-the-traders-a-trader-follows"}]},{"group":"Wallets","pages":[{"title":"Read one wallet and who owns it","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/wallets/{family}/{address}","href":"/v3/api-reference/wallets/read-one-wallet-and-who-owns-it"},{"title":"Read one wallet's PnL across the whole wallet","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/wallets/{family}/{address}/pnl","href":"/v3/api-reference/wallets/read-one-wallets-pnl-across-the-whole-wallet"},{"title":"Read the PnL of up to 100 wallets","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json post /v3/wallets/pnl","href":"/v3/api-reference/wallets/read-the-pnl-of-up-to-100-wallets"}]},{"group":"Posts","pages":[{"title":"Read the post feed","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/posts","href":"/v3/api-reference/posts/read-the-post-feed"},{"title":"Read the posts about a token","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/tokens/{network}/{address}/posts","href":"/v3/api-reference/posts/read-the-posts-about-a-token"},{"title":"Read the posts of a trader","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/traders/{traderId}/posts","href":"/v3/api-reference/posts/read-the-posts-of-a-trader"}]},{"group":"Tokens","pages":[{"title":"Read one token","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/tokens/{network}/{address}","href":"/v3/api-reference/tokens/read-one-token"}]},{"group":"Leaderboards","pages":[{"title":"List the leaderboards platforms publish","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/leaderboards","href":"/v3/api-reference/leaderboards/list-the-leaderboards-platforms-publish"},{"title":"Read one capture of a platform leaderboard","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/leaderboards/{platform}/{board}","href":"/v3/api-reference/leaderboards/read-one-capture-of-a-platform-leaderboard"}]},{"group":"Rankings","pages":[{"title":"List our rankings","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/rankings","href":"/v3/api-reference/rankings/list-our-rankings"},{"title":"Read the newest snapshot of one of our rankings","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/rankings/{key}","href":"/v3/api-reference/rankings/read-the-newest-snapshot-of-one-of-our-rankings"}]},{"group":"Account","pages":[{"title":"Read the calling key, its plan and its usage","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/me","href":"/v3/api-reference/account/read-the-calling-key-its-plan-and-its-usage"},{"title":"Read which platform provides which block","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/capabilities","href":"/v3/api-reference/account/read-which-platform-provides-which-block"}]},{"group":"Trades","pages":[{"title":"Read the newest trades of the traders we mapped","description":"The newest on-chain trades of the wallets we mapped to a trader, on every network we index, newest first. Each trade names its owner.\n\n- A wallet appears when a trader holds an active link to it, at any tier. A link read from the wallet a platform profile shows never counts; every other active link does, at its tier.\n- `owner` is the first owner the wallet envelope lists, with the tier capped as there: a wallet two traders hold shows one of them at `weak`.\n- `network` and `side` narrow the feed.\n- Quantities only: read prices from `GET /v3/tokens/{network}/{address}`.\n- Order: block time newest first, then trade id. A trade without a block time is left out.\n- Paged with `cursor` and `limit` (default 20, maximum 100). Follow `nextCursor` to read older rows.\n\n## Price\n\n**200 credits per started 20 rows of `limit`**, plus **100 credits and one reveal for each distinct trader the page shows as an owner**, on every call. A trader on two pages takes two reveals.\n\n| Answer | Credits | Reveals |\n| --- | --- | --- |\n| `limit` 20 (the default), an empty page. | 200 | 0 |\n| `limit` 20 (the default), the page shows 5 distinct traders. | 700 | 5 |\n| `limit` 100 (the maximum), an empty page. | 1,000 | 0 |\n| `limit` 100 (the maximum), the page shows 12 distinct traders. | 2,200 | 12 |\n\nReveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 `REVEAL_LIMIT_REACHED`, or 403 `PERMISSION_DENIED` for a key on a free plan without reveals.\n\n## Limits\n\n- 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key.\n- A key with less than 200 credits left gets 402 `QUOTA_EXCEEDED` before any work.","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/trades","href":"/v3/api-reference/trades/read-the-newest-trades-of-the-traders-we-mapped"},{"title":"Read the trades of a trader's wallets","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/traders/{traderId}/trades","href":"/v3/api-reference/trades/read-the-trades-of-a-traders-wallets"},{"title":"Read the trades of one wallet","description":"The trades of one wallet, mapped to a trader or not, newest first. `owner` is `null`: `GET /v3/wallets/{family}/{address}` names the owners.\n\n- `network` and `token` narrow the list.\n- A wallet without trades, or one we never saw, answers 200 with an empty page.\n- Order as in `GET /v3/trades`. Paged with `cursor` and `limit` (default 20, maximum 100). Follow `nextCursor` to read older rows.\n\n## Price\n\n**200 credits per started 20 rows of `limit`**, on every call. A short or empty page costs the same as a full one.\n\n| Answer | Credits | Reveals |\n| --- | --- | --- |\n| `limit` 1. | 200 | 0 |\n| `limit` 20 (the default). | 200 | 0 |\n| `limit` 50. | 600 | 0 |\n| `limit` 100 (the maximum). | 1,000 | 0 |\n\n## Limits\n\n- 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key.\n- A key with less than 200 credits left gets 402 `QUOTA_EXCEEDED` before any work.","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3/wallets/{family}/{address}/trades","href":"/v3/api-reference/trades/read-the-trades-of-one-wallet"}]},{"group":"WebSocket","pages":[{"title":"Live posts (WebSocket)","deprecated":null,"version":null,"openapi":"https://api.fomoscan.sh/v3/openapi.json get /v3","href":"/v3/api-reference/websocket/live-posts-websocket"}]}]}]},{"tab":"WebSocket","pages":[{"title":"WebSocket","href":"/v3/websocket/overview"}]}]}]},"basePath":"","title":"Read the trades of a trader's wallets - FomoScan","buildId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","deploymentId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-hfTk6MZX.js","utils-Bfp7HcY4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D8dSW7yV.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CFgQXcZO.js","snippetPresets-dMW1-pV3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DyrCOido.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Bwwdcyh3.js","shallow-drVXTg79.js","getApiPlaygroundDisplay-GMPxUzWV.js","CodeSnippet-wTmV0wP6.js","CodeSnippets-D_QxCJEq.js","Page-BsZAA8xk.js","getPastedJson-Dev-X0Xy.js","icon-7L2WL0jD.js","MethodPill-Ble59Dl_.js","DuplicateIcon-r-98uLGh.js","createIcon-DaFzipjW.js","DynamicMarkdown-Jk8YAWGN.js","SectionHeading-nLgrCDOg.js","axios-vUo_bRtp.js","Markdown-_QGow1Wo.js","clsx-v8ssfMzu.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CjboTi0T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DkAyo-p5.js"]}