Resolves a wallet address or Polymarket username to its canonical data
address and returns rolling 30-day weighted taker volume, current tier,
and progress toward the next tier.
GET
/
api
/
v1
/
users
/
taker-tier
Get a user's taker tier
curl --request GET \ --url https://data.gravia.trade/api/v1/users/taker-tier \ --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-users-taker-tier","slug":"/api-reference/users/get-a-users-taker-tier","pageMetadata":{"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","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"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 });\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 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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"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","operationId":"getUserTakerTier","x-feature-stage":"stable","tags":["Users"],"parameters":["3dbc29af-b4cc-4d4a-b205-dd5aae5a5e59"],"responses":{"200":"134a618e-5bda-4003-9a8a-6420a549b86d","400":"6ddaebbc-c7ed-429c-9656-2d41e634334c","401":"7e15d533-0e7b-4d15-95a8-5558f1fb9ee0","404":"2caf8aa2-71a3-49cf-a19f-f45bd72e68e9","429":"5c3e2900-359e-42aa-aded-f0e291fc32a7","500":"00ea9b27-083d-4041-8986-f92334273f0b"},"method":"get","type":"path","servers":["95aa4c4e-3c2a-41df-afae-71836d5c0fa7"],"security":["badce155-6f9b-410a-adb9-ddf6a04af289"],"path":"/api/v1/users/taker-tier","baseUrlOptions":["https://data.gravia.trade"],"title":"Get a user's taker tier","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3dbc29af-b4cc-4d4a-b205-dd5aae5a5e59":{"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":"@alice"}},"responses":{"134a618e-5bda-4003-9a8a-6420a549b86d":{"description":"Current taker tier and next-tier progress.","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":"Public user-result caching policy.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["user_address","weighted_volume_30d_usdc","current_tier","next_tier","weighted_volume_to_next_tier_usdc","observed_at"],"properties":{"user_address":{"type":"string","pattern":"^0x[0-9a-f]{40}$","description":"Canonical lowercase data address after EOA/Safe resolution.","isRequired":true,"uniqueKey":"user_address","typeLabel":"string"},"weighted_volume_30d_usdc":{"type":"number","format":"double","minimum":0,"isRequired":true,"uniqueKey":"weighted_volume_30d_usdc","typeLabel":"number\u003cdouble>"},"current_tier":{"type":"object","additionalProperties":false,"required":["number","name","min_weighted_volume_30d_usdc","rebate_percentage","bonus_usdc","image_url","color"],"properties":{"number":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"current_tier.number","typeLabel":"integer\u003cint64>"},"name":{"type":"string","isRequired":true,"uniqueKey":"current_tier.name","typeLabel":"string"},"min_weighted_volume_30d_usdc":{"type":"number","format":"double","minimum":0,"isRequired":true,"uniqueKey":"current_tier.min_weighted_volume_30d_usdc","typeLabel":"number\u003cdouble>"},"rebate_percentage":{"type":"number","format":"double","minimum":0,"isRequired":true,"uniqueKey":"current_tier.rebate_percentage","typeLabel":"number\u003cdouble>"},"bonus_usdc":{"oneOf":[{"type":"number","format":"double","isRequired":true,"uniqueKey":"current_tier.bonus_usdc.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","format":"double","isRequired":true,"uniqueKey":"current_tier.bonus_usdc.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"current_tier.bonus_usdc","typeLabel":"number\u003cdouble> | null"},"image_url":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"current_tier.image_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","isRequired":true,"uniqueKey":"current_tier.image_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"current_tier.image_url","typeLabel":"string\u003curi> | null"},"color":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"current_tier.color.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"current_tier.color.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"current_tier.color","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"current_tier","typeLabel":"object"},"next_tier":{"oneOf":[{"type":"object","required":["number","name","min_weighted_volume_30d_usdc","rebate_percentage","bonus_usdc","image_url","color"],"properties":{"number":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"next_tier.oneOf.0.number","typeLabel":"integer\u003cint64>"},"name":{"type":"string","isRequired":true,"uniqueKey":"next_tier.oneOf.0.name","typeLabel":"string"},"min_weighted_volume_30d_usdc":{"type":"number","format":"double","minimum":0,"isRequired":true,"uniqueKey":"next_tier.oneOf.0.min_weighted_volume_30d_usdc","typeLabel":"number\u003cdouble>"},"rebate_percentage":{"type":"number","format":"double","minimum":0,"isRequired":true,"uniqueKey":"next_tier.oneOf.0.rebate_percentage","typeLabel":"number\u003cdouble>"},"bonus_usdc":{"oneOf":[{"type":"number","format":"double","isRequired":true,"uniqueKey":"next_tier.oneOf.0.bonus_usdc.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","format":"double","isRequired":true,"uniqueKey":"next_tier.oneOf.0.bonus_usdc.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_tier.oneOf.0.bonus_usdc","typeLabel":"number\u003cdouble> | null"},"image_url":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"next_tier.oneOf.0.image_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","isRequired":true,"uniqueKey":"next_tier.oneOf.0.image_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_tier.oneOf.0.image_url","typeLabel":"string\u003curi> | null"},"color":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"next_tier.oneOf.0.color.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"next_tier.oneOf.0.color.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_tier.oneOf.0.color","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"next_tier.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"next_tier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_tier","typeLabel":"object | null"},"weighted_volume_to_next_tier_usdc":{"oneOf":[{"type":"number","format":"double","minimum":0,"description":"Null when the user is already at the maximum tier.","isRequired":true,"uniqueKey":"weighted_volume_to_next_tier_usdc.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","format":"double","minimum":0,"description":"Null when the user is already at the maximum tier.","isRequired":true,"uniqueKey":"weighted_volume_to_next_tier_usdc.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"weighted_volume_to_next_tier_usdc","typeLabel":"number\u003cdouble> | null"},"observed_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"observed_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"progress":{"title":"progress","value":{"user_address":"0x00000000000000000000000000000000000000ab","weighted_volume_30d_usdc":23456.78,"current_tier":{"number":2,"name":"Silver","min_weighted_volume_30d_usdc":20000,"rebate_percentage":8,"bonus_usdc":null,"image_url":"https://example.com/silver.png","color":"#c0c0c0"},"next_tier":{"number":3,"name":"Gold","min_weighted_volume_30d_usdc":50000,"rebate_percentage":10,"bonus_usdc":null,"image_url":"https://example.com/gold.png","color":"#ffd700"},"weighted_volume_to_next_tier_usdc":26543.22,"observed_at":"2026-07-13T12:34:56Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"6ddaebbc-c7ed-429c-9656-2d41e634334c":{"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"},"7e15d533-0e7b-4d15-95a8-5558f1fb9ee0":{"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"},"2caf8aa2-71a3-49cf-a19f-f45bd72e68e9":{"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"},"5c3e2900-359e-42aa-aded-f0e291fc32a7":{"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"},"00ea9b27-083d-4041-8986-f92334273f0b":{"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 user's taker tier - Gravia Data API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-27T11:39:29.551Z","originalFileLocation":"api-reference/users/get-a-users-taker-tier.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 to its canonical data address and returns rolling 30-day weighted taker volume, current tier, and progress toward the next tier.\">\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 user\u0026#x27;s taker tier - Gravia Data API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Resolves a wallet address or Polymarket username to its canonical data address and returns rolling 30-day weighted taker volume, current tier, and progress toward the next tier.\">\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-users-taker-tier\">\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+user%27s+taker+tier\u0026amp;description=Resolves+a+wallet+address+or+Polymarket+username+to+its+canonical+data%0Aaddress+and+returns+rolling+30-day+weighted+taker+volume%2C+current+tier%2C%0Aand+progress+towa\u0026amp;theme=8c421f2e72c1c7001e92ec31\u0026amp;signature=743f476097f1fd431fe4edee1638179c01a1a4deb4eea52a7c9a745f52137f10\">\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 user\u0026#x27;s taker tier - Gravia Data API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Resolves a wallet address or Polymarket username to its canonical data address and returns rolling 30-day weighted taker volume, current tier, and progress toward the next tier.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gravia-trade.mintlify.app/_mintlify/api/og/v2?division=Users\u0026amp;title=Get+a+user%27s+taker+tier\u0026amp;description=Resolves+a+wallet+address+or+Polymarket+username+to+its+canonical+data%0Aaddress+and+returns+rolling+30-day+weighted+taker+volume%2C+current+tier%2C%0Aand+progress+towa\u0026amp;theme=8c421f2e72c1c7001e92ec31\u0026amp;signature=743f476097f1fd431fe4edee1638179c01a1a4deb4eea52a7c9a745f52137f10\">\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-users-taker-tier\">\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-users-taker-tier.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-users-taker-tier#webpage\",\"url\":\"https://docs.gravia.trade/api-reference/users/get-a-users-taker-tier\",\"name\":\"Get a user's taker tier\",\"description\":\"Resolves a wallet address or Polymarket username to its canonical data address and returns rolling 30-day weighted taker volume, current tier, and progress toward the next tier.\",\"dateModified\":\"2026-09-27T11:39:29.551Z\",\"isPartOf\":{\"@id\":\"https://docs.gravia.trade#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gravia.trade/api-reference/users/get-a-users-taker-tier#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gravia.trade/api-reference/users/get-a-users-taker-tier#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 user's taker tier\",\"item\":\"https://docs.gravia.trade/api-reference/users/get-a-users-taker-tier\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gravia.trade/api-reference/users/get-a-users-taker-tier#apireference\",\"headline\":\"Get a user's taker tier\",\"name\":\"Get a user's taker tier\",\"description\":\"Resolves a wallet address or Polymarket username to its canonical data address and returns rolling 30-day weighted taker volume, current tier, and progress toward the next tier.\",\"url\":\"https://docs.gravia.trade/api-reference/users/get-a-users-taker-tier\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gravia.trade/api-reference/users/get-a-users-taker-tier#webpage\"},\"dateModified\":\"2026-09-27T11:39:29.551Z\",\"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","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","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"},{"title":"Get a user's taker tier","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","description":"Opens one authenticated WebSocket that receives normalized Chainlink\nData Streams prices.\n\n`symbols` and `variants` select the initial feeds. Omit both for all\n18 feeds, or use `symbols=none` to start empty. Subscriptions can then\nbe changed atomically with text JSON frames:\n\n```json\n{\"action\":\"subscribe\",\"subscriptions\":[{\"symbol\":\"btc\",\"variant\":\"spot\"}]}\n{\"action\":\"unsubscribe\",\"subscriptions\":[{\"symbol\":\"btc\",\"variant\":\"spot\"}]}\n{\"action\":\"subscription.list\"}\n{\"action\":\"ping\"}\n```\n\nThe server sends `welcome`, an initial `snapshot`, live `price`\nupdates, and idle `heartbeat` frames. A successful subscribe is\nacknowledged before its snapshot and before any live update for the\nnewly added feed. No update for a removed feed is queued after the\n`unsubscribed` acknowledgement. Prices are exact decimal strings.\n\nChainlink's live stream can occasionally omit an event. This endpoint\nperforms no REST reconciliation or backfill, so events missing from the\nupstream stream or dropped from Edge's bounded source queue are not\nreplayed or forwarded later.\n\nThe number of concurrent connections is assigned per API key; the service\ndefault is one. Browser clients may authenticate\nwith `api_key`; other clients should use the `Authorization` header.\nNew handshakes receive `503` while the upstream feed is stale.\n","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 user's taker tier - 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"]}