Resolves a wallet address or Polymarket username and returns a
lightweight current profile. Expensive history, analytics, category,
and rewards sections are loaded only when named in include.
GET
/
api
/
v1
/
users
/
profile
Get a concise user profile
curl --request GET \ --url https://data.gravia.trade/api/v1/users/profile \ --header 'Authorization: <api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Gravia Data API","colors":{"primary":"#9FFBFE","light":"#B8F7F8","dark":"#52CCD0"},"logo":{"light":"https://mintcdn.com/gravia-trade/q65mj9SyvyR5CJGQ/images/Gravia-black-logo.svg?fit=max\u0026auto=format\u0026n=q65mj9SyvyR5CJGQ\u0026q=85\u0026s=d20027ef4daf7f22158c1c43c271a664","dark":"https://mintcdn.com/gravia-trade/q65mj9SyvyR5CJGQ/images/Gravia-White-logo.svg?fit=max\u0026auto=format\u0026n=q65mj9SyvyR5CJGQ\u0026q=85\u0026s=ea11483c2fba835a236dce5eaafc0971"},"favicon":{"light":"https://mintcdn.com/gravia-trade/q65mj9SyvyR5CJGQ/images/Favicon-black.svg?fit=max\u0026auto=format\u0026n=q65mj9SyvyR5CJGQ\u0026q=85\u0026s=7592a349f8a038bd79006469a83390b7","dark":"https://mintcdn.com/gravia-trade/q65mj9SyvyR5CJGQ/images/Favicon-black.svg?fit=max\u0026auto=format\u0026n=q65mj9SyvyR5CJGQ\u0026q=85\u0026s=7592a349f8a038bd79006469a83390b7"},"background":{"color":{"light":"#ffffff","dark":"#09090B"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"},{"href":"https://discord.gg/REeFwe5HyN","label":"Discord"}]},"footer":{"socials":{"x":"https://x.com/graviahq","discord":"https://discord.gg/REeFwe5HyN"}},"fonts":{"family":"DM Sans"},"styling":{"codeblocks":"system","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"markdown":{"schema":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gravia-trade","hasAudioNarration":false,"actualSubdomain":"gravia-trade","customDomains":["docs.gravia.trade"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-gravia-trade-52698928","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"5160409f-d378-44bb-8ff7-93078be2816f","liveDeploymentHistoryId":"6abcdb7489c801142748f92e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6abcdb7489c801142748f92e"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6abcdb7489c801142748f92e","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":22},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Users","count":7},{"language":"default","tag":"Documentation","count":5},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"Markets","count":3},{"language":"default","tag":"Streams","count":2},{"language":"default","tag":"Operational","count":1}]},"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":"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":"byok-sep-25","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":"billing-updated-9-15","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}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/users/get-a-concise-user-profile","slug":"/api-reference/users/get-a-concise-user-profile","pageMetadata":{"title":"Get a concise user profile","description":"Resolves a wallet address or Polymarket username and returns a\nlightweight current profile. Expensive history, analytics, category,\nand rewards sections are loaded only when named in `include`.\n","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/profile","href":"/api-reference/users/get-a-concise-user-profile","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Resolves a wallet address or Polymarket username and returns a\\nlightweight current profile. Expensive history, analytics, category,\\nand rewards sections are loaded only when named in \", _jsx(_components.code, {\n children: \"include\"\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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Get a concise user profile","description":"Resolves a wallet address or Polymarket username and returns a\nlightweight current profile. Expensive history, analytics, category,\nand rewards sections are loaded only when named in `include`.\n","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/profile","href":"/api-reference/users/get-a-concise-user-profile","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get a concise user profile","description":"Resolves a wallet address or Polymarket username and returns a\nlightweight current profile. Expensive history, analytics, category,\nand rewards sections are loaded only when named in `include`.\n","operationId":"getUserProfile","x-feature-stage":"stable","tags":["Users"],"parameters":["eba57a1f-05fa-4ef3-a054-23f027fba6b6","39ae8cec-f94d-4ad6-a755-035840a615c1","1278d412-5826-4497-8f19-b438cc43df85","f22b449e-8508-42b9-94df-e8d2eb99687b"],"responses":{"200":"bcca9d72-f10d-4dde-a5e6-6b2b35dc11b7","400":"f94a3a08-3ff3-438d-8103-20d162e2b72b","401":"fff1395f-e6c9-4503-a916-1d14e74afa23","404":"2b687867-38e5-4e31-9e79-28e8c51c0dfa","429":"fe4e338d-cf32-41ad-88b7-2c6beb30e585","500":"6fac6197-586e-48f4-aad4-a24f201cf6af"},"method":"get","type":"path","servers":["95aa4c4e-3c2a-41df-afae-71836d5c0fa7"],"security":["badce155-6f9b-410a-adb9-ddf6a04af289"],"path":"/api/v1/users/profile","baseUrlOptions":["https://data.gravia.trade"],"title":"Get a concise user profile","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"eba57a1f-05fa-4ef3-a054-23f027fba6b6":{"name":"user","in":"query","required":true,"description":"A 20-byte 0x wallet address, @username, or bare Polymarket username.","schema":{"type":"string","minLength":1,"maxLength":255,"isRequired":true,"description":"A 20-byte 0x wallet address, @username, or bare Polymarket username.","uniqueKey":"","typeLabel":"string"},"example":"@bonereaper"},"39ae8cec-f94d-4ad6-a755-035840a615c1":{"name":"include","in":"query","required":false,"description":"Comma-separated optional response sections.","schema":{"type":"string","pattern":"^(history|analytics|categories|rewards)(,(history|analytics|categories|rewards))*$","isRequired":false,"description":"Comma-separated optional response sections.","uniqueKey":"","typeLabel":"string"},"example":"history,analytics"},"1278d412-5826-4497-8f19-b438cc43df85":{"name":"window_days","in":"query","required":false,"description":"Lookback for history, analytics risk metrics, and rewards. Requires a corresponding include.","schema":{"type":"integer","minimum":1,"maximum":365,"default":90,"isRequired":false,"description":"Lookback for history, analytics risk metrics, and rewards. Requires a corresponding include.","uniqueKey":"","typeLabel":"integer"}},"f22b449e-8508-42b9-94df-e8d2eb99687b":{"name":"bucket_cents","in":"query","required":false,"description":"Price-bucket width; must divide 100 evenly and requires include=analytics.","schema":{"type":"integer","enum":[1,2,4,5,10,20,25,50,100],"default":10,"isRequired":false,"description":"Price-bucket width; must divide 100 evenly and requires include=analytics.","uniqueKey":"","typeLabel":"enum\u003cinteger>"}}},"responses":{"bcca9d72-f10d-4dde-a5e6-6b2b35dc11b7":{"description":"Lightweight profile with any requested optional sections.","headers":{"X-Request-ID":{"description":"Correlation ID supplied by the client or generated by the server.","schema":{"type":"string"}},"X-API-Version":{"description":"API version that handled this request.","schema":{"type":"string","enum":["v1"]}},"RateLimit-Limit":{"description":"Request limit for the currently most restrictive policy tier.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests remaining in the currently most restrictive policy tier.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Whole seconds until capacity returns in the reported policy tier.","schema":{"type":"integer","minimum":0}},"Cache-Control":{"description":"Short public caching policy controlled by the server.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["address","username","profile_image_url","is_human","first_activity_at","last_activity_at","as_of","summary"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-f]{40}$","isRequired":true,"uniqueKey":"address","typeLabel":"string"},"username":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"username.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"username.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"username","typeLabel":"string | null"},"profile_image_url":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"profile_image_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","isRequired":true,"uniqueKey":"profile_image_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"profile_image_url","typeLabel":"string\u003curi> | null"},"is_human":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"is_human.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"is_human.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"is_human","typeLabel":"boolean | null"},"first_activity_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"first_activity_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"first_activity_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"first_activity_at","typeLabel":"string\u003cdate-time> | null"},"last_activity_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"last_activity_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"last_activity_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"last_activity_at","typeLabel":"string\u003cdate-time> | null"},"as_of":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"as_of","typeLabel":"string\u003cdate-time>"},"summary":{"type":"object","additionalProperties":false,"required":["realized_pnl_usdc","unrealized_pnl_usdc","total_pnl_usdc","market_value_usdc","volume_usdc","buy_volume_usdc","sell_volume_usdc","positions_count","trades_count","win_rate","roi","fees_usdc"],"properties":{"realized_pnl_usdc":{"type":"number","format":"double","isRequired":true,"uniqueKey":"summary.realized_pnl_usdc","typeLabel":"number\u003cdouble>"},"unrealized_pnl_usdc":{"type":"number","format":"double","isRequired":true,"uniqueKey":"summary.unrealized_pnl_usdc","typeLabel":"number\u003cdouble>"},"total_pnl_usdc":{"type":"number","format":"double","isRequired":true,"uniqueKey":"summary.total_pnl_usdc","typeLabel":"number\u003cdouble>"},"market_value_usdc":{"type":"number","format":"double","isRequired":true,"uniqueKey":"summary.market_value_usdc","typeLabel":"number\u003cdouble>"},"volume_usdc":{"type":"number","format":"double","isRequired":true,"uniqueKey":"summary.volume_usdc","typeLabel":"number\u003cdouble>"},"buy_volume_usdc":{"type":"number","format":"double","isRequired":true,"uniqueKey":"summary.buy_volume_usdc","typeLabel":"number\u003cdouble>"},"sell_volume_usdc":{"type":"number","format":"double","isRequired":true,"uniqueKey":"summary.sell_volume_usdc","typeLabel":"number\u003cdouble>"},"positions_count":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"summary.positions_count","typeLabel":"integer\u003cint64>"},"trades_count":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"summary.trades_count","typeLabel":"integer\u003cint64>"},"win_rate":{"oneOf":[{"type":"number","format":"double","isRequired":true,"uniqueKey":"summary.win_rate.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","format":"double","isRequired":true,"uniqueKey":"summary.win_rate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"summary.win_rate","typeLabel":"number\u003cdouble> | null"},"roi":{"oneOf":[{"type":"number","format":"double","isRequired":true,"uniqueKey":"summary.roi.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","format":"double","isRequired":true,"uniqueKey":"summary.roi.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"summary.roi","typeLabel":"number\u003cdouble> | null"},"fees_usdc":{"type":"number","format":"double","isRequired":true,"uniqueKey":"summary.fees_usdc","typeLabel":"number\u003cdouble>"}},"isRequired":true,"uniqueKey":"summary","typeLabel":"object"},"history":{"type":"object","additionalProperties":false,"required":["window_days","points"],"properties":{"window_days":{"type":"integer","minimum":1,"maximum":365,"isRequired":true,"uniqueKey":"history.window_days","typeLabel":"integer"},"points":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["date","realized_pnl_usdc","unrealized_pnl_usdc","total_pnl_usdc","market_value_usdc","volume_usdc","fees_usdc"],"properties":{"date":{"type":"string","format":"date","isRequired":true,"uniqueKey":"history.points.items.[INDEX].date","typeLabel":"string\u003cdate>"},"realized_pnl_usdc":{"type":"number","isRequired":true,"uniqueKey":"history.points.items.[INDEX].realized_pnl_usdc","typeLabel":"number"},"unrealized_pnl_usdc":{"type":"number","isRequired":true,"uniqueKey":"history.points.items.[INDEX].unrealized_pnl_usdc","typeLabel":"number"},"total_pnl_usdc":{"type":"number","isRequired":true,"uniqueKey":"history.points.items.[INDEX].total_pnl_usdc","typeLabel":"number"},"market_value_usdc":{"type":"number","isRequired":true,"uniqueKey":"history.points.items.[INDEX].market_value_usdc","typeLabel":"number"},"volume_usdc":{"type":"number","isRequired":true,"uniqueKey":"history.points.items.[INDEX].volume_usdc","typeLabel":"number"},"fees_usdc":{"type":"number","isRequired":true,"uniqueKey":"history.points.items.[INDEX].fees_usdc","typeLabel":"number"}},"uniqueKey":"history.points.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"history.points","typeLabel":"object[]"}},"uniqueKey":"history","typeLabel":"object"},"analytics":{"type":"object","additionalProperties":false,"required":["window_days","risk","activity","price_buckets","position_highlights"],"properties":{"window_days":{"type":"integer","minimum":1,"maximum":365,"isRequired":true,"uniqueKey":"analytics.window_days","typeLabel":"integer"},"risk":{"type":"object","additionalProperties":false,"required":["sharpe_ratio","sortino_ratio","max_drawdown_usdc","pnl_volatility_usdc","consistency_score","calmar_ratio"],"properties":{"sharpe_ratio":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"analytics.risk.sharpe_ratio.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"analytics.risk.sharpe_ratio.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analytics.risk.sharpe_ratio","typeLabel":"number | null"},"sortino_ratio":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"analytics.risk.sortino_ratio.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"analytics.risk.sortino_ratio.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analytics.risk.sortino_ratio","typeLabel":"number | null"},"max_drawdown_usdc":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"analytics.risk.max_drawdown_usdc.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"analytics.risk.max_drawdown_usdc.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analytics.risk.max_drawdown_usdc","typeLabel":"number | null"},"pnl_volatility_usdc":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"analytics.risk.pnl_volatility_usdc.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"analytics.risk.pnl_volatility_usdc.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analytics.risk.pnl_volatility_usdc","typeLabel":"number | null"},"consistency_score":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"analytics.risk.consistency_score.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"analytics.risk.consistency_score.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analytics.risk.consistency_score","typeLabel":"number | null"},"calmar_ratio":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"analytics.risk.calmar_ratio.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"analytics.risk.calmar_ratio.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analytics.risk.calmar_ratio","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"analytics.risk","typeLabel":"object"},"activity":{"type":"object","additionalProperties":false,"required":["typical_active_time_seconds_utc","active_time_spread_seconds"],"properties":{"typical_active_time_seconds_utc":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"analytics.activity.typical_active_time_seconds_utc.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"analytics.activity.typical_active_time_seconds_utc.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analytics.activity.typical_active_time_seconds_utc","typeLabel":"number | null"},"active_time_spread_seconds":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"analytics.activity.active_time_spread_seconds.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"analytics.activity.active_time_spread_seconds.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analytics.activity.active_time_spread_seconds","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"analytics.activity","typeLabel":"object"},"price_buckets":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["min_price","max_price","positions_count","volume_usdc","pnl_usdc"],"properties":{"min_price":{"type":"number","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"analytics.price_buckets.items.[INDEX].min_price","typeLabel":"number"},"max_price":{"type":"number","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"analytics.price_buckets.items.[INDEX].max_price","typeLabel":"number"},"positions_count":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"analytics.price_buckets.items.[INDEX].positions_count","typeLabel":"integer\u003cint64>"},"volume_usdc":{"type":"number","isRequired":true,"uniqueKey":"analytics.price_buckets.items.[INDEX].volume_usdc","typeLabel":"number"},"pnl_usdc":{"type":"number","isRequired":true,"uniqueKey":"analytics.price_buckets.items.[INDEX].pnl_usdc","typeLabel":"number"}},"uniqueKey":"analytics.price_buckets.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"analytics.price_buckets","typeLabel":"object[]"},"position_highlights":{"type":"object","additionalProperties":false,"required":["best_token_id","worst_token_id"],"properties":{"best_token_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"analytics.position_highlights.best_token_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"analytics.position_highlights.best_token_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analytics.position_highlights.best_token_id","typeLabel":"string | null"},"worst_token_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"analytics.position_highlights.worst_token_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"analytics.position_highlights.worst_token_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analytics.position_highlights.worst_token_id","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"analytics.position_highlights","typeLabel":"object"}},"uniqueKey":"analytics","typeLabel":"object"},"categories":{"type":"object","additionalProperties":false,"required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["slug","parent_slug","label","positions_count","open_positions_count","closed_positions_count","win_rate","total_pnl_usdc","volume_usdc","unique_markets_count"],"properties":{"slug":{"type":"string","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].slug","typeLabel":"string"},"parent_slug":{"type":"string","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].parent_slug","typeLabel":"string"},"label":{"type":"string","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].label","typeLabel":"string"},"positions_count":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].positions_count","typeLabel":"integer\u003cint64>"},"open_positions_count":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].open_positions_count","typeLabel":"integer\u003cint64>"},"closed_positions_count":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].closed_positions_count","typeLabel":"integer\u003cint64>"},"win_rate":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].win_rate.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].win_rate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].win_rate","typeLabel":"number | null"},"total_pnl_usdc":{"type":"number","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].total_pnl_usdc","typeLabel":"number"},"volume_usdc":{"type":"number","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].volume_usdc","typeLabel":"number"},"unique_markets_count":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"categories.\\items.items.[INDEX].unique_markets_count","typeLabel":"integer\u003cint64>"}},"uniqueKey":"categories.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"categories.\\items","typeLabel":"object[]"}},"uniqueKey":"categories","typeLabel":"object"},"rewards":{"type":"object","additionalProperties":false,"required":["totals","daily","maker_rebates"],"properties":{"totals":{"type":"object","required":["rebate_usdc","liquidity_usdc","holding_usdc","referral_usdc","taker_usdc"],"properties":{"rebate_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.totals.rebate_usdc","typeLabel":"number"},"liquidity_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.totals.liquidity_usdc","typeLabel":"number"},"holding_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.totals.holding_usdc","typeLabel":"number"},"referral_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.totals.referral_usdc","typeLabel":"number"},"taker_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.totals.taker_usdc","typeLabel":"number"}},"isRequired":true,"uniqueKey":"rewards.totals","typeLabel":"object"},"daily":{"type":"array","items":{"type":"object","required":["rebate_usdc","liquidity_usdc","holding_usdc","referral_usdc","taker_usdc","date"],"properties":{"date":{"type":"string","format":"date","isRequired":true,"uniqueKey":"rewards.daily.items.[INDEX].date","typeLabel":"string\u003cdate>"},"rebate_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.daily.items.[INDEX].rebate_usdc","typeLabel":"number"},"liquidity_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.daily.items.[INDEX].liquidity_usdc","typeLabel":"number"},"holding_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.daily.items.[INDEX].holding_usdc","typeLabel":"number"},"referral_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.daily.items.[INDEX].referral_usdc","typeLabel":"number"},"taker_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.daily.items.[INDEX].taker_usdc","typeLabel":"number"}},"uniqueKey":"rewards.daily.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"rewards.daily","typeLabel":"object[]"},"maker_rebates":{"type":"object","additionalProperties":false,"required":["total_usdc","days_count","markets_count","daily"],"properties":{"total_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.maker_rebates.total_usdc","typeLabel":"number"},"days_count":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"rewards.maker_rebates.days_count","typeLabel":"integer\u003cint64>"},"markets_count":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"rewards.maker_rebates.markets_count","typeLabel":"integer\u003cint64>"},"daily":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["date","amount_usdc","markets_count"],"properties":{"date":{"type":"string","format":"date","isRequired":true,"uniqueKey":"rewards.maker_rebates.daily.items.[INDEX].date","typeLabel":"string\u003cdate>"},"amount_usdc":{"type":"number","isRequired":true,"uniqueKey":"rewards.maker_rebates.daily.items.[INDEX].amount_usdc","typeLabel":"number"},"markets_count":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"rewards.maker_rebates.daily.items.[INDEX].markets_count","typeLabel":"integer\u003cint64>"}},"uniqueKey":"rewards.maker_rebates.daily.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"rewards.maker_rebates.daily","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"rewards.maker_rebates","typeLabel":"object"}},"uniqueKey":"rewards","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"base":{"title":"base","value":{"address":"0x00000000000000000000000000000000000000ab","username":"alice","profile_image_url":"https://example.com/alice.png","is_human":true,"first_activity_at":"2025-01-01T12:00:00Z","last_activity_at":"2026-07-13T12:30:00Z","as_of":"2026-07-13T12:34:56Z","summary":{"realized_pnl_usdc":1250.25,"unrealized_pnl_usdc":30.5,"total_pnl_usdc":1280.75,"market_value_usdc":875.2,"volume_usdc":50000,"buy_volume_usdc":26000,"sell_volume_usdc":24000,"positions_count":42,"trades_count":180,"win_rate":63.5,"roi":0.049,"fees_usdc":25.1}}}},"exampleType":"examples"}},"exampleType":"examples"},"f94a3a08-3ff3-438d-8103-20d162e2b72b":{"description":"The request could not be completed.","headers":{"X-Request-ID":{"description":"Correlation ID supplied by the client or generated by the server.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code. Branch on this rather than on\n`message`, which may be reworded at any time.\n\n| Code | Status | Meaning |\n| --- | --- | --- |\n| `invalid_request` | 400 | A parameter is missing, malformed, or out of range. |\n| `unauthorized` | 401 | The API key is missing, unknown, or revoked. |\n| `cors_origin_denied` | 403 | The browser origin is not on the deployment's allowlist. |\n| `not_found` | 404 | The requested resource does not exist. |\n| `profile_not_found` | 404 | The `user` value did not resolve to a known profile. |\n| `method_not_allowed` | 405 | The path exists but not for this HTTP method. |\n| `rate_limit_exceeded` | 429 | A sliding-window rate limit was exceeded; honor `Retry-After`. |\n| `stream_limit_reached` | 429 | This API key reached its concurrent allowance for the stream; close an existing connection instead of retrying. |\n| `internal_error` | 500 | Unexpected server-side failure. |\n| `service_unavailable` | 503 | A required backend is not configured or reachable. |\n| `temporarily_unavailable` | 503 | A backend is briefly degraded; retry after a short pause. |\n","example":"invalid_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description. Not a stable contract.","example":"user is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation ID for support and log lookup, mirroring the\n`X-Request-ID` response header.\n","example":"01f6c90f31d24db3a25c7dba6ca071ee","uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"user is required","request_id":"01f6c90f31d24db3a25c7dba6ca071ee"}}}},"exampleType":"generated"}},"exampleType":"generated"},"fff1395f-e6c9-4503-a916-1d14e74afa23":{"description":"The request could not be completed.","headers":{"X-Request-ID":{"description":"Correlation ID supplied by the client or generated by the server.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code. Branch on this rather than on\n`message`, which may be reworded at any time.\n\n| Code | Status | Meaning |\n| --- | --- | --- |\n| `invalid_request` | 400 | A parameter is missing, malformed, or out of range. |\n| `unauthorized` | 401 | The API key is missing, unknown, or revoked. |\n| `cors_origin_denied` | 403 | The browser origin is not on the deployment's allowlist. |\n| `not_found` | 404 | The requested resource does not exist. |\n| `profile_not_found` | 404 | The `user` value did not resolve to a known profile. |\n| `method_not_allowed` | 405 | The path exists but not for this HTTP method. |\n| `rate_limit_exceeded` | 429 | A sliding-window rate limit was exceeded; honor `Retry-After`. |\n| `stream_limit_reached` | 429 | This API key reached its concurrent allowance for the stream; close an existing connection instead of retrying. |\n| `internal_error` | 500 | Unexpected server-side failure. |\n| `service_unavailable` | 503 | A required backend is not configured or reachable. |\n| `temporarily_unavailable` | 503 | A backend is briefly degraded; retry after a short pause. |\n","example":"invalid_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description. Not a stable contract.","example":"user is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation ID for support and log lookup, mirroring the\n`X-Request-ID` response header.\n","example":"01f6c90f31d24db3a25c7dba6ca071ee","uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"user is required","request_id":"01f6c90f31d24db3a25c7dba6ca071ee"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2b687867-38e5-4e31-9e79-28e8c51c0dfa":{"description":"The request could not be completed.","headers":{"X-Request-ID":{"description":"Correlation ID supplied by the client or generated by the server.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code. Branch on this rather than on\n`message`, which may be reworded at any time.\n\n| Code | Status | Meaning |\n| --- | --- | --- |\n| `invalid_request` | 400 | A parameter is missing, malformed, or out of range. |\n| `unauthorized` | 401 | The API key is missing, unknown, or revoked. |\n| `cors_origin_denied` | 403 | The browser origin is not on the deployment's allowlist. |\n| `not_found` | 404 | The requested resource does not exist. |\n| `profile_not_found` | 404 | The `user` value did not resolve to a known profile. |\n| `method_not_allowed` | 405 | The path exists but not for this HTTP method. |\n| `rate_limit_exceeded` | 429 | A sliding-window rate limit was exceeded; honor `Retry-After`. |\n| `stream_limit_reached` | 429 | This API key reached its concurrent allowance for the stream; close an existing connection instead of retrying. |\n| `internal_error` | 500 | Unexpected server-side failure. |\n| `service_unavailable` | 503 | A required backend is not configured or reachable. |\n| `temporarily_unavailable` | 503 | A backend is briefly degraded; retry after a short pause. |\n","example":"invalid_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description. Not a stable contract.","example":"user is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation ID for support and log lookup, mirroring the\n`X-Request-ID` response header.\n","example":"01f6c90f31d24db3a25c7dba6ca071ee","uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"user is required","request_id":"01f6c90f31d24db3a25c7dba6ca071ee"}}}},"exampleType":"generated"}},"exampleType":"generated"},"fe4e338d-cf32-41ad-88b7-2c6beb30e585":{"description":"The API-key and endpoint sliding-window policy was exceeded.","headers":{"X-Request-ID":{"description":"Correlation ID supplied by the client or generated by the server.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Request limit for the currently most restrictive policy tier.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests remaining in the currently most restrictive policy tier.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Whole seconds until capacity returns in the reported policy tier.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Whole seconds before the rate-limited request should be retried.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code. Branch on this rather than on\n`message`, which may be reworded at any time.\n\n| Code | Status | Meaning |\n| --- | --- | --- |\n| `invalid_request` | 400 | A parameter is missing, malformed, or out of range. |\n| `unauthorized` | 401 | The API key is missing, unknown, or revoked. |\n| `cors_origin_denied` | 403 | The browser origin is not on the deployment's allowlist. |\n| `not_found` | 404 | The requested resource does not exist. |\n| `profile_not_found` | 404 | The `user` value did not resolve to a known profile. |\n| `method_not_allowed` | 405 | The path exists but not for this HTTP method. |\n| `rate_limit_exceeded` | 429 | A sliding-window rate limit was exceeded; honor `Retry-After`. |\n| `stream_limit_reached` | 429 | This API key reached its concurrent allowance for the stream; close an existing connection instead of retrying. |\n| `internal_error` | 500 | Unexpected server-side failure. |\n| `service_unavailable` | 503 | A required backend is not configured or reachable. |\n| `temporarily_unavailable` | 503 | A backend is briefly degraded; retry after a short pause. |\n","example":"invalid_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description. Not a stable contract.","example":"user is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation ID for support and log lookup, mirroring the\n`X-Request-ID` response header.\n","example":"01f6c90f31d24db3a25c7dba6ca071ee","uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"rate_limit_exceeded","message":"rate limit exceeded","request_id":"01f6c90f31d24db3a25c7dba6ca071ee"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limit_exceeded","message":"rate limit exceeded","request_id":"01f6c90f31d24db3a25c7dba6ca071ee"}}}},"exampleType":"examples"}},"exampleType":"examples"},"6fac6197-586e-48f4-aad4-a24f201cf6af":{"description":"The request could not be completed.","headers":{"X-Request-ID":{"description":"Correlation ID supplied by the client or generated by the server.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code. Branch on this rather than on\n`message`, which may be reworded at any time.\n\n| Code | Status | Meaning |\n| --- | --- | --- |\n| `invalid_request` | 400 | A parameter is missing, malformed, or out of range. |\n| `unauthorized` | 401 | The API key is missing, unknown, or revoked. |\n| `cors_origin_denied` | 403 | The browser origin is not on the deployment's allowlist. |\n| `not_found` | 404 | The requested resource does not exist. |\n| `profile_not_found` | 404 | The `user` value did not resolve to a known profile. |\n| `method_not_allowed` | 405 | The path exists but not for this HTTP method. |\n| `rate_limit_exceeded` | 429 | A sliding-window rate limit was exceeded; honor `Retry-After`. |\n| `stream_limit_reached` | 429 | This API key reached its concurrent allowance for the stream; close an existing connection instead of retrying. |\n| `internal_error` | 500 | Unexpected server-side failure. |\n| `service_unavailable` | 503 | A required backend is not configured or reachable. |\n| `temporarily_unavailable` | 503 | A backend is briefly degraded; retry after a short pause. |\n","example":"invalid_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description. Not a stable contract.","example":"user is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation ID for support and log lookup, mirroring the\n`X-Request-ID` response header.\n","example":"01f6c90f31d24db3a25c7dba6ca071ee","uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"user is required","request_id":"01f6c90f31d24db3a25c7dba6ca071ee"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"badce155-6f9b-410a-adb9-ddf6a04af289":{"APIKey":{"type":"apiKey","in":"header","name":"Authorization","description":"Raw database-backed API key.","scopes":[]}}},"servers":{"95aa4c4e-3c2a-41df-afae-71836d5c0fa7":{"url":"https://data.gravia.trade","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Raw database-backed API key.","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Raw database-backed API key.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKey","name":"Authorization"}],"title":"APIKey"}]},"originalFileLocation":"https://data.gravia.trade/"},"subdomain":"gravia-trade","siteName":"Gravia Data API","title":"Get a concise user profile - Gravia Data API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-27T11:39:29.540Z","originalFileLocation":"api-reference/users/get-a-concise-user-profile.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=\"Resolves a wallet address or Polymarket username and returns a lightweight current profile. Expensive history, analytics, category, and rewards sections are loaded only when named in include.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Gravia Data API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_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/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_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/gravia-trade/UCUg-2SVPMUpHKiA/_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/gravia-trade/UCUg-2SVPMUpHKiA/_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/gravia-trade/UCUg-2SVPMUpHKiA/_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/gravia-trade/UCUg-2SVPMUpHKiA/_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/gravia-trade/UCUg-2SVPMUpHKiA/_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/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a concise user profile - Gravia Data API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Resolves a wallet address or Polymarket username and returns a lightweight current profile. Expensive history, analytics, category, and rewards sections are loaded only when named in include.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gravia Data API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gravia.trade/api-reference/users/get-a-concise-user-profile\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gravia-trade.mintlify.app/_mintlify/api/og/v2?division=Users\u0026amp;title=Get+a+concise+user+profile\u0026amp;description=Resolves+a+wallet+address+or+Polymarket+username+and+returns+a%0Alightweight+current+profile.+Expensive+history%2C+analytics%2C+category%2C%0Aand+rewards+sections+are+loa\u0026amp;theme=8c421f2e72c1c7001e92ec31\u0026amp;signature=3b38cbcf90608affde2349746a21563a456475a55858d8c1f9d430d96222077c\">\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=\"Get a concise user profile - Gravia Data API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Resolves a wallet address or Polymarket username and returns a lightweight current profile. Expensive history, analytics, category, and rewards sections are loaded only when named in include.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gravia-trade.mintlify.app/_mintlify/api/og/v2?division=Users\u0026amp;title=Get+a+concise+user+profile\u0026amp;description=Resolves+a+wallet+address+or+Polymarket+username+and+returns+a%0Alightweight+current+profile.+Expensive+history%2C+analytics%2C+category%2C%0Aand+rewards+sections+are+loa\u0026amp;theme=8c421f2e72c1c7001e92ec31\u0026amp;signature=3b38cbcf90608affde2349746a21563a456475a55858d8c1f9d430d96222077c\">\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/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gravia Data API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9FFBFE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gravia.trade/api-reference/users/get-a-concise-user-profile\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/users/get-a-concise-user-profile.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gravia.trade/#organization\",\"name\":\"Gravia Data API\",\"url\":\"https://docs.gravia.trade\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gravia-trade/q65mj9SyvyR5CJGQ/images/Gravia-black-logo.svg?fit=max\u0026auto=format\u0026n=q65mj9SyvyR5CJGQ\u0026q=85\u0026s=d20027ef4daf7f22158c1c43c271a664\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gravia.trade#website\",\"name\":\"Gravia Data API\",\"url\":\"https://docs.gravia.trade\",\"publisher\":{\"@id\":\"https://docs.gravia.trade/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gravia.trade/api-reference/users/get-a-concise-user-profile#webpage\",\"url\":\"https://docs.gravia.trade/api-reference/users/get-a-concise-user-profile\",\"name\":\"Get a concise user profile\",\"description\":\"Resolves a wallet address or Polymarket username and returns a lightweight current profile. Expensive history, analytics, category, and rewards sections are loaded only when named in include.\",\"dateModified\":\"2026-09-27T11:39:29.540Z\",\"isPartOf\":{\"@id\":\"https://docs.gravia.trade#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gravia.trade/api-reference/users/get-a-concise-user-profile#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gravia.trade/api-reference/users/get-a-concise-user-profile#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Users\",\"item\":\"https://docs.gravia.trade/api-reference/users/get-a-users-trades-and-on-chain-activities\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a concise user profile\",\"item\":\"https://docs.gravia.trade/api-reference/users/get-a-concise-user-profile\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gravia.trade/api-reference/users/get-a-concise-user-profile#apireference\",\"headline\":\"Get a concise user profile\",\"name\":\"Get a concise user profile\",\"description\":\"Resolves a wallet address or Polymarket username and returns a lightweight current profile. Expensive history, analytics, category, and rewards sections are loaded only when named in include.\",\"url\":\"https://docs.gravia.trade/api-reference/users/get-a-concise-user-profile\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gravia.trade/api-reference/users/get-a-concise-user-profile#webpage\"},\"dateModified\":\"2026-09-27T11:39:29.540Z\",\"publisher\":{\"@id\":\"https://docs.gravia.trade/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gravia.trade#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Gravia Data API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Gravia Data API","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Webhooks","pages":[{"title":"List owned webhooks","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /v1/webhooks","href":"/api-reference/webhooks/list-owned-webhooks"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ post /v1/webhooks","href":"/api-reference/webhooks/create-a-webhook"},{"title":"List supported webhook events","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /v1/webhooks/events","href":"/api-reference/webhooks/list-supported-webhook-events"},{"title":"Get an owned webhook","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /v1/webhooks/{id}","href":"/api-reference/webhooks/get-an-owned-webhook"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ put /v1/webhooks/{id}","href":"/api-reference/webhooks/update-a-webhook"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ delete /v1/webhooks/{id}","href":"/api-reference/webhooks/delete-a-webhook"},{"title":"Rotate signing secret","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ post /v1/webhooks/{id}/rotate-secret","href":"/api-reference/webhooks/rotate-signing-secret"},{"title":"Send a test callback","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ post /v1/webhooks/{id}/test","href":"/api-reference/webhooks/send-a-test-callback"},{"title":"List terminal delivery logs","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /v1/webhooks/{id}/logs","href":"/api-reference/webhooks/list-terminal-delivery-logs"}]},{"group":"Operational","pages":[{"title":"Health check","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /health","href":"/api-reference/operational/health-check"}]},{"group":"Markets","pages":[{"title":"Get the current crypto up/down market","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/markets/crypto/current","href":"/api-reference/markets/get-the-current-crypto-updown-market"},{"title":"List market categories","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/markets/categories/list","href":"/api-reference/markets/list-market-categories"},{"title":"Get a market's price to beat","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/markets/crypto/price-to-beat","href":"/api-reference/markets/get-a-markets-price-to-beat"}]},{"group":"Users","pages":[{"title":"Get a user's trades and on-chain activities","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/activities","href":"/api-reference/users/get-a-users-trades-and-on-chain-activities"},{"title":"Get a user's trades with markouts","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/trades/markouts","href":"/api-reference/users/get-a-users-trades-with-markouts"},{"title":"Get markouts grouped by counterparty","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/trades/counterparties","href":"/api-reference/users/get-markouts-grouped-by-counterparty"},{"title":"Get one profile's category metrics","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/categories","href":"/api-reference/users/get-one-profiles-category-metrics"},{"title":"Get a user's positions","description":"Resolves a wallet address or Polymarket username and returns a curated,\npaginated view of current holdings. Supplying start_date switches the\nresponse to per-position performance. Without end_date, performance\nruns through the current live portfolio; with end_date, it covers that\ninclusive closed UTC range.\n","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/positions","href":"/api-reference/users/get-a-users-positions"},{"title":"Get a concise user profile","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/profile","href":"/api-reference/users/get-a-concise-user-profile"},{"title":"Get a user's taker tier","description":"Resolves a wallet address or Polymarket username to its canonical data\naddress and returns rolling 30-day weighted taker volume, current tier,\nand progress toward the next tier.\n","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/taker-tier","href":"/api-reference/users/get-a-users-taker-tier"}]},{"group":"Streams","pages":[{"title":"WebSocket stream of Chainlink crypto prices","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/streams/crypto-prices","href":"/api-reference/streams/websocket-stream-of-chainlink-crypto-prices"},{"title":"WebSocket stream of live trades, activities and conversions","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/streams/transactions","href":"/api-reference/streams/websocket-stream-of-live-trades-activities-and-conversions"}]}]}]},"basePath":"","title":"Get a concise user profile - Gravia Data API","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}