Return the global top 100 participating master accounts by trading PnL or cash-flow-adjusted time-weighted return. Username filtering only reduces that selected top 100. Return can be null when no positive-equity subperiod exists; positive dollar PnL and negative TWR can coexist.
GET
/
public
/
leaderboard
Public Leaderboard
curl --request GET \ --url https://api.qfex.com/public/leaderboard
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"QFEX API Documentation","colors":{"primary":"#38A5A0","light":"#38A5A0","dark":"#38A5A0"},"logo":{"light":"https://mintcdn.com/qfex/_KzvrZZNknwtc25D/logo/light.svg?fit=max\u0026auto=format\u0026n=_KzvrZZNknwtc25D\u0026q=85\u0026s=d91fb93b918683d2d0a4c0517ca8c4af","dark":"https://mintcdn.com/qfex/_KzvrZZNknwtc25D/logo/dark.svg?fit=max\u0026auto=format\u0026n=_KzvrZZNknwtc25D\u0026q=85\u0026s=4a7afe5885910915c87c239f874ffc62","href":"https://qfex.com"},"favicon":"https://mintcdn.com/qfex/_KzvrZZNknwtc25D/favicon.svg?fit=max\u0026auto=format\u0026n=_KzvrZZNknwtc25D\u0026q=85\u0026s=b46838d937d798434426fba1b1771841","background":{"color":{"light":"#F9FAFB","dark":"#172027"}},"navbar":{"links":[{"href":"mailto:support@qfex.com","label":"Support"}],"primary":{"type":"button","label":"Trade Now","href":"https://qfex.com/trade"}},"footer":{"socials":{"x":"https://x.com/QFEX","github":"https://github.com/QFEX-org","linkedin":"https://linkedin.com/company/qfex","discord":"https://discord.qfex.com"}},"fonts":{"family":"DM Sans"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"signal-bars","href":"https://status.qfex.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"qfex","hasAudioNarration":false,"actualSubdomain":"qfex","customDomains":["docs.qfex.com"],"gitSource":{"type":"github","owner":"qfex-org","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb53c8a0e78eb4aee8e2eb","collectionId":"76f298a8-3379-47ff-b00e-3cd964ca45c7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb53c8a0e78eb4aee8e2eb"},"entitlements":{},"buildId":"6adb53c8a0e78eb4aee8e2eb","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"API Reference","count":90},{"language":"default","tag":"REST API","count":41},{"language":"default","tag":"WebSocket","count":34},{"language":"default","tag":"user","count":25},{"language":"default","tag":"QFEX","count":23},{"language":"default","tag":"Trade","count":21},{"language":"default","tag":"Trading Rulebook","count":13},{"language":"default","tag":"market-data","count":12},{"language":"default","tag":"Market Data","count":10},{"language":"default","tag":"API Documentation","count":9}]},"assistantConfig":{},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/rest/public/public-leaderboard","slug":"/api-reference/rest/public/public-leaderboard","pageMetadata":{"title":"Public Leaderboard","description":"Return the global top 100 participating master accounts by trading PnL or cash-flow-adjusted time-weighted return. Username filtering only reduces that selected top 100. Return can be null when no positive-equity subperiod exists; positive dollar PnL and negative TWR can coexist.","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /public/leaderboard","href":"/api-reference/rest/public/public-leaderboard","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: \"Return the global top 100 participating master accounts by trading PnL or cash-flow-adjusted time-weighted return. Username filtering only reduces that selected top 100. Return can be null when no positive-equity subperiod exists; positive dollar PnL and negative TWR can coexist.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Public Leaderboard","description":"Return the global top 100 participating master accounts by trading PnL or cash-flow-adjusted time-weighted return. Username filtering only reduces that selected top 100. Return can be null when no positive-equity subperiod exists; positive dollar PnL and negative TWR can coexist.","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /public/leaderboard","href":"/api-reference/rest/public/public-leaderboard","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/qfex/56c86559303091d8/fetch-enums.js","/_mintlify/custom/qfex/17c1628ea2303021/generate-specification-index.js","/_mintlify/custom/qfex/247bca39b96714fa/generate-roll-schedules.js"],"openApiReferenceData":{"operation":{"description":"Return the global top 100 participating master accounts by trading PnL or cash-flow-adjusted time-weighted return. Username filtering only reduces that selected top 100. Return can be null when no positive-equity subperiod exists; positive dollar PnL and negative TWR can coexist.","operationId":"read-public-leaderboard","parameters":["81b5829e-de1f-46ba-9a06-d950b9a1531c","3b1385cd-e2c9-41b0-91db-288f06b4a4c3","c1f7de48-c5d3-4a6c-8a56-2cbe62517cfb"],"responses":{"200":"be837ec4-8eb6-4ae0-9c78-cf8adb76a40c","default":"a16890e8-602c-4546-b10d-b181361a7faf"},"security":[],"summary":"Public Leaderboard","tags":["public"],"method":"get","type":"path","servers":["d15d5f74-f66b-44c3-bdfb-7060d9834b09"],"path":"/public/leaderboard","baseUrlOptions":["https://api.qfex.com"],"title":"Public Leaderboard","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"81b5829e-de1f-46ba-9a06-d950b9a1531c":{"explode":false,"in":"query","name":"duration","schema":{"default":"1w","type":"string","uniqueKey":"","typeLabel":"string"}},"3b1385cd-e2c9-41b0-91db-288f06b4a4c3":{"explode":false,"in":"query","name":"sort","schema":{"default":"absolute","type":"string","uniqueKey":"","typeLabel":"string"}},"c1f7de48-c5d3-4a6c-8a56-2cbe62517cfb":{"explode":false,"in":"query","name":"query","schema":{"type":"string","uniqueKey":"","typeLabel":"string"}}},"responses":{"be837ec4-8eb6-4ae0-9c78-cf8adb76a40c":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"count":{"format":"int64","type":"integer","isRequired":true,"uniqueKey":"count","typeLabel":"integer\u003cint64>"},"data":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"account":{"additionalProperties":false,"properties":{"account_id":{"format":"uuid","type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].account.account_id","typeLabel":"string\u003cuuid>"},"is_public":{"type":"boolean","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].account.is_public","typeLabel":"boolean"},"user_id":{"format":"uuid","type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].account.user_id","typeLabel":"string\u003cuuid>"},"avatar_url":{"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].account.avatar_url","typeLabel":"string"},"username":{"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].account.username","typeLabel":"string"}},"required":["account_id","user_id","is_public"],"type":"object","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].account","typeLabel":"object"},"end_equity":{"format":"double","type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].end_equity","typeLabel":"number\u003cdouble>"},"pnl":{"format":"double","type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].pnl","typeLabel":"number\u003cdouble>"},"rank":{"format":"int64","type":"integer","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].rank","typeLabel":"integer\u003cint64>"},"return_percent":{"oneOf":[{"format":"double","type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].return_percent.oneOf.0","typeLabel":"number\u003cdouble>"},{"format":"double","type":"null","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].return_percent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].return_percent","typeLabel":"number\u003cdouble> | null"},"start_equity":{"format":"double","type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].start_equity","typeLabel":"number\u003cdouble>"}},"required":["rank","account","pnl","return_percent","start_equity","end_equity"],"type":"object","uniqueKey":"data.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"object[]"},{"items":{"additionalProperties":false,"properties":{"account":{"additionalProperties":false,"properties":{"account_id":{"format":"uuid","type":"string"},"avatar_url":{"type":"string"},"is_public":{"type":"boolean"},"user_id":{"format":"uuid","type":"string"},"username":{"type":"string"}},"required":["account_id","user_id","is_public"],"type":"object"},"end_equity":{"format":"double","type":"number"},"pnl":{"format":"double","type":"number"},"rank":{"format":"int64","type":"integer"},"return_percent":{"oneOf":[{"format":"double","type":"number"},{"format":"double","type":"null"}]},"start_equity":{"format":"double","type":"number"}},"required":["rank","account","pnl","return_percent","start_equity","end_equity"],"type":"object"},"type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"object[] | null"},"duration":{"type":"string","isRequired":true,"uniqueKey":"duration","typeLabel":"string"},"end":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"end","typeLabel":"string\u003cdate-time>"},"sort":{"type":"string","isRequired":true,"uniqueKey":"sort","typeLabel":"string"},"$schema":{"description":"A URL to the JSON Schema for this object.","examples":["https://api.qfex.com/schemas/PublicLeaderboardResponseBody.json"],"format":"uri","readOnly":true,"type":"string","uniqueKey":"$schema","typeLabel":"string\u003curi>"},"start":{"format":"date-time","type":"string","uniqueKey":"start","typeLabel":"string\u003cdate-time>"}},"required":["duration","sort","end","data","count"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"count":123,"data":[{"account":{"account_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","is_public":true,"user_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","avatar_url":"\u003cstring>","username":"\u003cstring>"},"end_equity":123,"pnl":123,"rank":123,"return_percent":123,"start_equity":123}],"duration":"\u003cstring>","end":"2023-11-07T05:31:56Z","sort":"\u003cstring>","$schema":"https://api.qfex.com/schemas/PublicLeaderboardResponseBody.json","start":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"a16890e8-602c-4546-b10d-b181361a7faf":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"properties":{"$schema":{"description":"A URL to the JSON Schema for this object.","examples":["https://api.qfex.com/schemas/ErrorModel.json"],"format":"uri","readOnly":true,"type":"string","uniqueKey":"$schema","typeLabel":"string\u003curi>"},"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"$schema":"https://api.qfex.com/schemas/ErrorModel.json","detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Error","exampleType":"generated"}},"security":{},"servers":{"d15d5f74-f66b-44c3-bdfb-7060d9834b09":{"description":"Production server","url":"https://api.qfex.com"}}},"originalFileLocation":"https://api.qfex.com/openapi.yaml"},"subdomain":"qfex","siteName":"QFEX API Documentation","title":"Public Leaderboard - QFEX API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T12:32:16.893Z","originalFileLocation":"api-reference/rest/public/public-leaderboard.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=\"Return the global top 100 participating master accounts by trading PnL or cash-flow-adjusted time-weighted return. Username filtering only reduces that selected top 100. Return can be null when no positive-equity subperiod exists; positive dollar PnL and negative TWR can coexist.\">\u003cmeta data-mint-head name=\"application-name\" content=\"QFEX API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/qfex/NR4Uw7CiIxkYf2rd/_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/qfex/NR4Uw7CiIxkYf2rd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/qfex/NR4Uw7CiIxkYf2rd/_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/qfex/NR4Uw7CiIxkYf2rd/_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/qfex/NR4Uw7CiIxkYf2rd/_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/qfex/NR4Uw7CiIxkYf2rd/_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/qfex/NR4Uw7CiIxkYf2rd/_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/qfex/NR4Uw7CiIxkYf2rd/_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/qfex/NR4Uw7CiIxkYf2rd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Public Leaderboard - QFEX API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Return the global top 100 participating master accounts by trading PnL or cash-flow-adjusted time-weighted return. Username filtering only reduces that selected top 100. Return can be null when no positive-equity subperiod exists; positive dollar PnL and negative TWR can coexist.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"QFEX API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.qfex.com/api-reference/rest/public/public-leaderboard\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://qfex.mintlify.app/_mintlify/api/og/v2?division=public\u0026amp;title=Public+Leaderboard\u0026amp;description=Return+the+global+top+100+participating+master+accounts+by+trading+PnL+or+cash-flow-adjusted+time-weighted+return.+Username+filtering+only+reduces+that+selected\u0026amp;theme=6f799b45432d65b231563cba\u0026amp;signature=0fd6b5509af7e5d11a6487e3c2f19d179333fb5b237c36335cc7d94097daf309\">\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=\"Public Leaderboard - QFEX API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Return the global top 100 participating master accounts by trading PnL or cash-flow-adjusted time-weighted return. Username filtering only reduces that selected top 100. Return can be null when no positive-equity subperiod exists; positive dollar PnL and negative TWR can coexist.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://qfex.mintlify.app/_mintlify/api/og/v2?division=public\u0026amp;title=Public+Leaderboard\u0026amp;description=Return+the+global+top+100+participating+master+accounts+by+trading+PnL+or+cash-flow-adjusted+time-weighted+return.+Username+filtering+only+reduces+that+selected\u0026amp;theme=6f799b45432d65b231563cba\u0026amp;signature=0fd6b5509af7e5d11a6487e3c2f19d179333fb5b237c36335cc7d94097daf309\">\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/qfex/NR4Uw7CiIxkYf2rd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"QFEX API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#38A5A0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.qfex.com/api-reference/rest/public/public-leaderboard\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/rest/public/public-leaderboard.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.qfex.com/#organization\",\"name\":\"QFEX API Documentation\",\"url\":\"https://docs.qfex.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/qfex/_KzvrZZNknwtc25D/logo/light.svg?fit=max\u0026auto=format\u0026n=_KzvrZZNknwtc25D\u0026q=85\u0026s=d91fb93b918683d2d0a4c0517ca8c4af\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.qfex.com#website\",\"name\":\"QFEX API Documentation\",\"url\":\"https://docs.qfex.com\",\"publisher\":{\"@id\":\"https://docs.qfex.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.qfex.com/api-reference/rest/public/public-leaderboard#webpage\",\"url\":\"https://docs.qfex.com/api-reference/rest/public/public-leaderboard\",\"name\":\"Public Leaderboard\",\"description\":\"Return the global top 100 participating master accounts by trading PnL or cash-flow-adjusted time-weighted return. Username filtering only reduces that selected top 100. Return can be null when no positive-equity subperiod exists; positive dollar PnL and negative TWR can coexist.\",\"dateModified\":\"2026-10-23T12:32:16.893Z\",\"isPartOf\":{\"@id\":\"https://docs.qfex.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.qfex.com/api-reference/rest/public/public-leaderboard#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.qfex.com/api-reference/rest/public/public-leaderboard#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://docs.qfex.com/api-reference/rest/builder/generate-a-wallet-users-main-account-trading-key\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Public Leaderboard\",\"item\":\"https://docs.qfex.com/api-reference/rest/public/public-leaderboard\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.qfex.com/api-reference/rest/public/public-leaderboard#apireference\",\"headline\":\"Public Leaderboard\",\"name\":\"Public Leaderboard\",\"description\":\"Return the global top 100 participating master accounts by trading PnL or cash-flow-adjusted time-weighted return. Username filtering only reduces that selected top 100. Return can be null when no positive-equity subperiod exists; positive dollar PnL and negative TWR can coexist.\",\"url\":\"https://docs.qfex.com/api-reference/rest/public/public-leaderboard\",\"mainEntityOfPage\":{\"@id\":\"https://docs.qfex.com/api-reference/rest/public/public-leaderboard#webpage\"},\"dateModified\":\"2026-10-23T12:32:16.893Z\",\"publisher\":{\"@id\":\"https://docs.qfex.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.qfex.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"QFEX API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"QFEX API Documentation","nav":{"global":{"anchors":[{"anchor":"Status","icon":"signal-bars","href":"https://status.qfex.com"}]},"tabs":[{"tab":"QFEX","pages":[{"title":"QFEX","href":"/qfex/about"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"API Keys","href":"/api-reference/api-keys"},{"title":"Wallet authentication","href":"/api-reference/wallet-authentication"},{"title":"Programmatic deposits and withdrawals","href":"/api-reference/programmatic-funding"},{"title":"CLI","href":"/api-reference/cli"},{"title":"Enums","href":"/api-reference/enums"},{"title":"Errors","href":"/websocket/errors"},{"title":"API Rate Limits","href":"/websocket/rate"},{"title":"Changelog","href":"/websocket/changelog"}]},{"group":"Builder Codes","pages":[{"title":"Builder Integration Guide","href":"/api-reference/builder-integration"},{"title":"Builder wallet registration","href":"/api-reference/builder-wallet-registration"},{"title":"Builder Codes API","href":"/api-reference/builder-codes"}]},{"group":"REST API","pages":[{"group":"builder","pages":[{"title":"Generate a wallet user's main-account trading key","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml post /builder/web3/api-key","href":"/api-reference/rest/builder/generate-a-wallet-users-main-account-trading-key"},{"title":"Get the wallet message for a builder trading key","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /builder/web3/message","href":"/api-reference/rest/builder/get-the-wallet-message-for-a-builder-trading-key"}]},{"group":"market-data","pages":[{"title":"Candles","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /candles/{symbol}","href":"/api-reference/rest/market-data/candles"},{"title":"DefiLlama Metrics","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /defillama/metrics","href":"/api-reference/rest/market-data/defillama-metrics"},{"title":"Funding Historic","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /funding/{symbol}","href":"/api-reference/rest/market-data/funding-historic"},{"title":"Contracts","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /md/contracts","href":"/api-reference/rest/market-data/contracts"},{"title":"Order Book","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /md/orderbook/{ticker_id}","href":"/api-reference/rest/market-data/order-book"},{"title":"Open Interest Historic","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /open-interest/{symbol}","href":"/api-reference/rest/market-data/open-interest-historic"},{"title":"Refdata","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /refdata","href":"/api-reference/rest/market-data/refdata"},{"title":"Settlement Calendar","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /settlement-calendar","href":"/api-reference/rest/market-data/settlement-calendar"},{"title":"Settlement Prices","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /settlement-prices","href":"/api-reference/rest/market-data/settlement-prices"},{"title":"Symbol Long Short Historic","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /symbol-long-short/{symbol}","href":"/api-reference/rest/market-data/symbol-long-short-historic"},{"title":"Taker Volume Historic","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /taker-volume/{symbol}","href":"/api-reference/rest/market-data/taker-volume-historic"},{"title":"Underlier Historic","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /underlier/{symbol}","href":"/api-reference/rest/market-data/underlier-historic"}]},{"group":"user","pages":[{"title":"Executions","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /executions","href":"/api-reference/rest/user/executions"},{"title":"Stream Historic Orders CSV","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /historic-orders-csv","href":"/api-reference/rest/user/stream-historic-orders-csv"},{"title":"Stream Historic TWAPs CSV","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /historic-twaps-csv","href":"/api-reference/rest/user/stream-historic-twaps-csv"},{"title":"Redeem Invitation Code","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml post /redeem-invitation-code","href":"/api-reference/rest/user/redeem-invitation-code"},{"title":"Stream Trades CSV","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /trades-csv","href":"/api-reference/rest/user/stream-trades-csv"},{"title":"Account Equity","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/account-equity","href":"/api-reference/rest/user/account-equity"},{"title":"Builder Code Details","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/builder-code","href":"/api-reference/rest/user/builder-code-details"},{"title":"Create Builder Code","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml post /user/builder-code","href":"/api-reference/rest/user/create-builder-code"},{"title":"User Fees","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/fees","href":"/api-reference/rest/user/user-fees"},{"title":"User Flat Funding","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/flat-funding","href":"/api-reference/rest/user/user-flat-funding"},{"title":"Historic Orders","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/historic-orders","href":"/api-reference/rest/user/historic-orders"},{"title":"Historic User PnL","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/historic-pnl","href":"/api-reference/rest/user/historic-user-pnl"},{"title":"Historic TWAPs","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/historic-twaps","href":"/api-reference/rest/user/historic-twaps"},{"title":"Reconcile Invitation Codes (Legacy Path)","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml post /user/invitation-codes/job","href":"/api-reference/rest/user/reconcile-invitation-codes-legacy-path"},{"title":"Set User Leverage","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml post /user/leverage","href":"/api-reference/rest/user/set-user-leverage"},{"title":"User Positions","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/positions","href":"/api-reference/rest/user/user-positions"},{"title":"User Referral Rewards","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/referral-rewards","href":"/api-reference/rest/user/user-referral-rewards"},{"title":"User Referral Notional Volume","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/referrals/notional-volume","href":"/api-reference/rest/user/user-referral-notional-volume"},{"title":"List Subaccounts","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/subaccounts","href":"/api-reference/rest/user/list-subaccounts"},{"title":"Create Subaccount","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml post /user/subaccounts","href":"/api-reference/rest/user/create-subaccount"},{"title":"List Account Balances","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/subaccounts/balance","href":"/api-reference/rest/user/list-account-balances"},{"title":"List Account Equities","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/subaccounts/equity","href":"/api-reference/rest/user/list-account-equities"},{"title":"User Trades","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/trade","href":"/api-reference/rest/user/user-trades"},{"title":"Transfer Balance","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml post /user/transfer","href":"/api-reference/rest/user/transfer-balance"},{"title":"User Volume","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /user/volume","href":"/api-reference/rest/user/user-volume"}]},{"group":"pnl","pages":[{"title":"Hourly PnL (approx. first position per hour)","description":"Return approximate first position per symbol per hour for the user, including realised/unrealised pnl, net_funding, fees, quantity, and cost.","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /pnl","href":"/api-reference/rest/pnl/hourly-pnl-approx-first-position-per-hour"}]},{"group":"public","pages":[{"title":"Public Leaderboard","deprecated":null,"version":null,"openapi":"https://api.qfex.com/openapi.yaml get /public/leaderboard","href":"/api-reference/rest/public/public-leaderboard"}]}]},{"group":"Funding API","pages":[{"group":"funding","pages":[{"title":"Get a crypto deposit address","description":"API keys require view_balance. Returns the existing deposit address or provisions one on the first call without rotating an existing address. ARBITRUM_ONE deposits USDC; TRON deposits USDT. POST /address/rotate requires deposit_withdraw.","deprecated":null,"version":null,"openapi":"/api-reference/funding-openapi.yaml get /address","href":"/api-reference/funding/funding/get-a-crypto-deposit-address"},{"title":"List registered crypto withdrawal addresses","deprecated":null,"version":null,"openapi":"/api-reference/funding-openapi.yaml get /withdrawal-addresses","href":"/api-reference/funding/funding/list-registered-crypto-withdrawal-addresses"},{"title":"Request a crypto withdrawal to a registered address","deprecated":null,"version":null,"openapi":"/api-reference/funding-openapi.yaml post /withdraw","href":"/api-reference/funding/funding/request-a-crypto-withdrawal-to-a-registered-address"}]}]},{"group":"WebSocket","pages":[{"title":"Websocket Overview","href":"/websocket/main"},{"title":"Trade Playground","asyncapi":"websocket/trade.yaml qfex","href":"/websocket/trade"},{"title":"MDS Playground","asyncapi":"websocket/mds.yaml qfex","href":"/websocket/mds"},{"group":"Market Data","pages":[{"title":"Reference Data","href":"/websocket/channels/mds/refdata"},{"title":"Pulsed Order Book","href":"/websocket/channels/mds/orderbook"},{"title":"Public Trades","href":"/websocket/channels/mds/trades"},{"title":"Pulsed BBO","href":"/websocket/channels/mds/bbo"},{"title":"Underlier Price","href":"/websocket/channels/mds/underlier"},{"title":"Funding Rate","href":"/websocket/channels/mds/funding_rate"},{"title":"Mark Price","href":"/websocket/channels/mds/mark_price"},{"title":"Open Interest","href":"/websocket/channels/mds/open_interest"},{"title":"Minmax Price","href":"/websocket/channels/mds/minmax_price"},{"title":"Market Stats","href":"/websocket/channels/mds/market_stats"}]},{"group":"Trade","pages":[{"title":"Authenticate","href":"/websocket/channels/trade/authenticate"},{"title":"Subscribe — Order Responses","href":"/websocket/channels/trade/order"},{"title":"Subscribe — Fills","href":"/websocket/channels/trade/fills"},{"title":"Order Entry — Add Order","href":"/websocket/channels/trade/add_order"},{"title":"Order Entry — Cancel Order","href":"/websocket/channels/trade/cancel_order"},{"title":"Order Entry — Modify Order","href":"/websocket/channels/trade/modify_order"},{"title":"Cancel All Orders","href":"/websocket/channels/trade/cancel_all_orders"},{"title":"Order Entry — Close Position","href":"/websocket/channels/trade/close_position"},{"title":"Order Entry — Add TWAP","href":"/websocket/channels/trade/add_twap"},{"title":"Get User Orders","href":"/websocket/channels/trade/get_user_orders"},{"title":"Get Order","href":"/websocket/channels/trade/get_order"},{"title":"Get User Trades","href":"/websocket/channels/trade/get_user_trades"},{"title":"Subscribe — Balances","href":"/websocket/channels/trade/balance"},{"title":"Subscribe — Positions","href":"/websocket/channels/trade/positions"},{"title":"Get Leverage Levels","href":"/websocket/channels/trade/get_leverage"},{"title":"Get Available Leverage Levels","href":"/websocket/channels/trade/get_available_leverage"},{"title":"Set Leverage","href":"/websocket/channels/trade/set_leverage"},{"title":"Cancel On Disconnect","href":"/websocket/channels/trade/cancel_on_disconnect"},{"title":"Order Entry — Add Stop Order","href":"/websocket/channels/trade/stop_add_order"},{"title":"Order Entry — Cancel Stop Order","href":"/websocket/channels/trade/stop_cancel_order"},{"title":"Order Entry — Modify Stop Order","href":"/websocket/channels/trade/stop_modify_order"}]}]}]},{"tab":"Legal","pages":[{"title":"Legal","href":"/legal/client-agreement"}]}]},"title":"Public Leaderboard - QFEX API Documentation","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}