The global leaderboard scoped to your own referred users: each row is that user’s own referral standing (their referred count and referral earnings), keeping the global ranking. Only referred users who are themselves earning referrers appear. The response never carries a me block.
GET
/
referral
/
usdc
/
leaderboard
/
friends
Get Friends Leaderboard
curl --request GET \ --url https://api.limitless.exchange/referral/usdc/leaderboard/friends \ --header 'lmts-api-key: <api-key>'
The global leaderboard scoped to your own referred users. Each row is that user’s own referral standing (their referred count and their referral earnings — not your cut from them), keeping the global ranking.
Only referred users who are themselves earning referrers appear, so the board can be sparse until your network grows. The response never carries a me block.
Scoped API token with HMAC-SHA256 signing. Requires three headers: lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature (Base64-encoded HMAC). See Authentication docs for details.
Your own rank and entry, pinned even when outside the returned page. Present on the global board when the request is authenticated; null when you have no ranked position; omitted on the friends board.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Limitless Exchange","colors":{"primary":"#9AB83A","light":"#DCF58C","dark":"#7A9A1E"},"logo":{"light":"https://mintcdn.com/limitless/r7gW3TwphUtCZ8zM/logo/light.svg?fit=max\u0026auto=format\u0026n=r7gW3TwphUtCZ8zM\u0026q=85\u0026s=0d6f32ed5e8a1f35ba9d1fa2e0b57a4b","dark":"https://mintcdn.com/limitless/r7gW3TwphUtCZ8zM/logo/dark.svg?fit=max\u0026auto=format\u0026n=r7gW3TwphUtCZ8zM\u0026q=85\u0026s=6500e01609e582f758db1a9610b63bd8"},"favicon":"https://mintcdn.com/limitless/r7gW3TwphUtCZ8zM/favicon.svg?fit=max\u0026auto=format\u0026n=r7gW3TwphUtCZ8zM\u0026q=85\u0026s=345f02206803d94b3b1911d2a80bf9c3","api":{"playground":{}},"navbar":{"links":[{"href":"mailto:help@limitless.network","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/trylimitless","discord":"https://discord.com/invite/yb4SscD8RZ"}},"seo":{"metatags":{"twitter:card":"summary_large_image"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Limitless Exchange","icon":"arrow-up-right-from-square","href":"https://limitless.exchange"},{"anchor":"Builders Chat","icon":"telegram","href":"https://t.me/LimitlessBuildersChat"},{"anchor":"Discord","icon":"discord","href":"https://discord.com/invite/yb4SscD8RZ"},{"anchor":"Twitter","icon":"x-twitter","href":"https://x.com/trylimitless"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"limitless","hasAudioNarration":false,"actualSubdomain":"limitless","customDomains":["docs.limitless.exchange"],"gitSource":{"type":"github","owner":"limitless-labs-group","repo":"limitless-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae2027fd6a250fd1db9a4f3","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API Reference","count":81},{"language":"default","tag":"For Developers","count":67},{"language":"default","tag":"User Guide","count":26},{"language":"default","tag":"Portfolio","count":14},{"language":"default","tag":"Trading","count":14},{"language":"default","tag":"Getting Started","count":14},{"language":"default","tag":"Go SDK","count":11},{"language":"default","tag":"Python SDK","count":11},{"language":"default","tag":"Rust SDK","count":11},{"language":"default","tag":"TypeScript SDK","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/referral/leaderboard-friends","slug":"/api-reference/referral/leaderboard-friends","pageMetadata":{"title":"Get Friends Leaderboard","openapi":"GET /referral/usdc/leaderboard/friends","description":"The global leaderboard scoped to your own referred users: each row is that user's own referral standing (their referred count and referral earnings), keeping the global ranking. Only referred users who are themselves earning referrers appear. The response never carries a `me` block.","href":"/api-reference/referral/leaderboard-friends"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"The global leaderboard scoped to your own referred users: each row is that user’s own referral standing (their referred count and referral earnings), keeping the global ranking. Only referred users who are themselves earning referrers appear. The response never carries a \", _jsx(_components.code, {\n children: \"me\"\n }), \" block.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Info}=_components;if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The global leaderboard scoped to your own referred users. Each row is that user’s `,_jsx(_components.strong,{children:`own`}),` referral standing (their referred count and their referral earnings — not your cut from them), keeping the global ranking.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Only referred users who are themselves earning referrers appear, so the board can be sparse until your network grows. The response never carries a `,_jsx(_components.code,{children:`me`}),` block.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Friends Leaderboard","openapi":"GET /referral/usdc/leaderboard/friends","description":"The global leaderboard scoped to your own referred users: each row is that user's own referral standing (their referred count and referral earnings), keeping the global ranking. Only referred users who are themselves earning referrers appear. The response never carries a `me` block.","href":"/api-reference/referral/leaderboard-friends"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get Friends Leaderboard","description":"The global leaderboard scoped to your own referred users: each row is that user's own referral standing (their referred count and referral earnings), keeping the global ranking. Only referred users who are themselves earning referrers appear. The response never carries a `me` block.","operationId":"ReferralUsdcController_getFriendsLeaderboard","parameters":["9fd5c8bf-91f1-45d6-b012-aefba3559387","1945d5df-b9cc-4d29-b550-bdb5d31fc985","06effc1c-f681-472e-a3d1-790def4f8b06","7a39ecf5-8cd1-47c1-b0fe-1e1b8ce66494"],"responses":{"200":"9c767d64-c5e6-4cfe-8931-b4fb4014f667","400":"5195e7c3-87f3-4877-ac9b-5e826d3c13bf","401":"08ea31a4-7f0b-4b6f-8e94-5e604d34ccb1"},"security":["33fef9d1-53c8-4caa-aa68-54fd27f43a4a"],"tags":["Referral"],"method":"get","type":"path","servers":["09c89b92-1b1b-488d-af55-0f936f286701"],"path":"/referral/usdc/leaderboard/friends","baseUrlOptions":["https://api.limitless.exchange"],"title":"Get Friends Leaderboard","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9fd5c8bf-91f1-45d6-b012-aefba3559387":{"name":"limit","required":false,"in":"query","description":"Number of items per page (1-100).","schema":{"type":"number","minimum":1,"maximum":100,"default":100,"isRequired":false,"description":"Number of items per page (1-100).","uniqueKey":"","typeLabel":"number"}},"1945d5df-b9cc-4d29-b550-bdb5d31fc985":{"name":"offset","required":false,"in":"query","description":"Offset into the result set.","schema":{"type":"number","default":0,"minimum":0,"maximum":10000,"isRequired":false,"description":"Offset into the result set.","uniqueKey":"","typeLabel":"number"}},"06effc1c-f681-472e-a3d1-790def4f8b06":{"name":"sortBy","required":false,"in":"query","description":"Sort column.","schema":{"type":"string","enum":["earned","fees","referred"],"default":"earned","isRequired":false,"description":"Sort column.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"7a39ecf5-8cd1-47c1-b0fe-1e1b8ce66494":{"name":"sortOrder","required":false,"in":"query","description":"Sort direction.","schema":{"type":"string","enum":["ASC","DESC"],"default":"DESC","isRequired":false,"description":"Sort direction.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"9c767d64-c5e6-4cfe-8931-b4fb4014f667":{"description":"Ranked page of your referred users who are earning referrers","content":{"application/json":{"schema":{"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"account":{"type":"string","description":"The referrer's account address.","isRequired":true,"uniqueKey":"entries.items.[INDEX].account","typeLabel":"string"},"avatarAccount":{"type":"string","description":"Address used to derive the fallback avatar.","isRequired":true,"uniqueKey":"entries.items.[INDEX].avatarAccount","typeLabel":"string"},"displayName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"entries.items.[INDEX].displayName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"entries.items.[INDEX].displayName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"entries.items.[INDEX].displayName","typeLabel":"string | null"},"earnedRaw":{"type":"string","description":"Total USDC this referrer has earned from the program. Raw USDC with 6 decimals, returned as a string. Divide by 1e6 for the dollar amount.","isRequired":true,"uniqueKey":"entries.items.[INDEX].earnedRaw","typeLabel":"string"},"feesGeneratedRaw":{"type":"string","description":"Total taker fees this referrer's referred users have generated. Raw USDC with 6 decimals, returned as a string. Divide by 1e6 for the dollar amount.","isRequired":true,"uniqueKey":"entries.items.[INDEX].feesGeneratedRaw","typeLabel":"string"},"pfpUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"entries.items.[INDEX].pfpUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"entries.items.[INDEX].pfpUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"entries.items.[INDEX].pfpUrl","typeLabel":"string | null"},"rank":{"type":"number","description":"Absolute rank under the active sort. Ranks stay absolute across pages.","isRequired":true,"uniqueKey":"entries.items.[INDEX].rank","typeLabel":"number"},"referredCount":{"type":"number","description":"Number of credited referred users.","isRequired":true,"uniqueKey":"entries.items.[INDEX].referredCount","typeLabel":"number"},"referrerProfileId":{"type":"number","isRequired":true,"uniqueKey":"entries.items.[INDEX].referrerProfileId","typeLabel":"number"},"username":{"oneOf":[{"type":"string","description":"The referrer's public username. Prefer this over displayName for labels; displayName often holds a wallet address.","isRequired":true,"uniqueKey":"entries.items.[INDEX].username.oneOf.0","typeLabel":"string"},{"type":"null","description":"The referrer's public username. Prefer this over displayName for labels; displayName often holds a wallet address.","isRequired":true,"uniqueKey":"entries.items.[INDEX].username.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"entries.items.[INDEX].username","typeLabel":"string | null"}},"required":["account","avatarAccount","displayName","earnedRaw","feesGeneratedRaw","pfpUrl","rank","referredCount","referrerProfileId","username"],"uniqueKey":"entries.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"entries","typeLabel":"object[]"},"limit":{"type":"number","isRequired":true,"uniqueKey":"limit","typeLabel":"number"},"offset":{"type":"number","isRequired":true,"uniqueKey":"offset","typeLabel":"number"},"total":{"type":"number","description":"Total ranked referrers on the board.","isRequired":true,"uniqueKey":"total","typeLabel":"number"},"me":{"oneOf":[{"type":"object","description":"Your own rank and entry, pinned even when outside the returned page. Present on the global board when the request is authenticated; null when you have no ranked position; omitted on the friends board.","required":["entry","rank"],"properties":{"entry":{"type":"object","properties":{"account":{"type":"string","description":"The referrer's account address.","isRequired":true,"uniqueKey":"me.oneOf.0.entry.account","typeLabel":"string"},"avatarAccount":{"type":"string","description":"Address used to derive the fallback avatar.","isRequired":true,"uniqueKey":"me.oneOf.0.entry.avatarAccount","typeLabel":"string"},"displayName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"me.oneOf.0.entry.displayName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"me.oneOf.0.entry.displayName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"me.oneOf.0.entry.displayName","typeLabel":"string | null"},"earnedRaw":{"type":"string","description":"Total USDC this referrer has earned from the program. Raw USDC with 6 decimals, returned as a string. Divide by 1e6 for the dollar amount.","isRequired":true,"uniqueKey":"me.oneOf.0.entry.earnedRaw","typeLabel":"string"},"feesGeneratedRaw":{"type":"string","description":"Total taker fees this referrer's referred users have generated. Raw USDC with 6 decimals, returned as a string. Divide by 1e6 for the dollar amount.","isRequired":true,"uniqueKey":"me.oneOf.0.entry.feesGeneratedRaw","typeLabel":"string"},"pfpUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"me.oneOf.0.entry.pfpUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"me.oneOf.0.entry.pfpUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"me.oneOf.0.entry.pfpUrl","typeLabel":"string | null"},"rank":{"type":"number","description":"Absolute rank under the active sort. Ranks stay absolute across pages.","isRequired":true,"uniqueKey":"me.oneOf.0.entry.rank","typeLabel":"number"},"referredCount":{"type":"number","description":"Number of credited referred users.","isRequired":true,"uniqueKey":"me.oneOf.0.entry.referredCount","typeLabel":"number"},"referrerProfileId":{"type":"number","isRequired":true,"uniqueKey":"me.oneOf.0.entry.referrerProfileId","typeLabel":"number"},"username":{"oneOf":[{"type":"string","description":"The referrer's public username. Prefer this over displayName for labels; displayName often holds a wallet address.","isRequired":true,"uniqueKey":"me.oneOf.0.entry.username.oneOf.0","typeLabel":"string"},{"type":"null","description":"The referrer's public username. Prefer this over displayName for labels; displayName often holds a wallet address.","isRequired":true,"uniqueKey":"me.oneOf.0.entry.username.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"me.oneOf.0.entry.username","typeLabel":"string | null"}},"required":["account","avatarAccount","displayName","earnedRaw","feesGeneratedRaw","pfpUrl","rank","referredCount","referrerProfileId","username"],"isRequired":true,"uniqueKey":"me.oneOf.0.entry","typeLabel":"object"},"rank":{"type":"number","description":"Your absolute rank under the active sort.","isRequired":true,"uniqueKey":"me.oneOf.0.rank","typeLabel":"number"}},"uniqueKey":"me.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"me.oneOf.1","typeLabel":"null"}],"uniqueKey":"me","typeLabel":"object | null"}},"required":["entries","limit","offset","total"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"entries":[{"account":"\u003cstring>","avatarAccount":"\u003cstring>","displayName":"\u003cstring>","earnedRaw":"\u003cstring>","feesGeneratedRaw":"\u003cstring>","pfpUrl":"\u003cstring>","rank":123,"referredCount":123,"referrerProfileId":123,"username":"\u003cstring>"}],"limit":123,"offset":123,"total":123,"me":{"entry":{"account":"\u003cstring>","avatarAccount":"\u003cstring>","displayName":"\u003cstring>","earnedRaw":"\u003cstring>","feesGeneratedRaw":"\u003cstring>","pfpUrl":"\u003cstring>","rank":123,"referredCount":123,"referrerProfileId":123,"username":"\u003cstring>"},"rank":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"5195e7c3-87f3-4877-ac9b-5e826d3c13bf":{"description":"Invalid query parameters","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"08ea31a4-7f0b-4b6f-8e94-5e604d34ccb1":{"description":"Unauthorized","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"33fef9d1-53c8-4caa-aa68-54fd27f43a4a":{"HmacAuth":{"type":"apiKey","in":"header","name":"lmts-api-key","description":"Scoped API token with HMAC-SHA256 signing. Requires three headers: lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature (Base64-encoded HMAC). See Authentication docs for details.","scopes":[],"schemeName":"HmacAuth"}}},"servers":{"09c89b92-1b1b-488d-af55-0f936f286701":{"url":"https://api.limitless.exchange","description":"Production API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"lmts-api-key","description":"Scoped API token with HMAC-SHA256 signing. Requires three headers: lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature (Base64-encoded HMAC). See Authentication docs for details.","scopes":[],"schemeName":"HmacAuth"},"schema":{"title":"lmts-api-key","type":"string","description":"Scoped API token with HMAC-SHA256 signing. Requires three headers: lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature (Base64-encoded HMAC). See Authentication docs for details.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"HmacAuth","name":"lmts-api-key"}],"title":"HmacAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"limitless","siteName":"Limitless Exchange","title":"Get Friends Leaderboard - Limitless Exchange","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-28T18:37:12.840Z","originalFileLocation":"api-reference/referral/leaderboard-friends.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=\"The global leaderboard scoped to your own referred users: each row is that user\u0026#x27;s own referral standing (their referred count and referral earnings), keeping the global ranking. Only referred users who are themselves earning referrers appear. The response never carries a me block.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Limitless Exchange\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/limitless/eKG_O-mKVQpNZHIN/_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/limitless/eKG_O-mKVQpNZHIN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/limitless/eKG_O-mKVQpNZHIN/_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/limitless/eKG_O-mKVQpNZHIN/_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/limitless/eKG_O-mKVQpNZHIN/_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/limitless/eKG_O-mKVQpNZHIN/_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/limitless/eKG_O-mKVQpNZHIN/_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/limitless/eKG_O-mKVQpNZHIN/_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/limitless/eKG_O-mKVQpNZHIN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Friends Leaderboard - Limitless Exchange\">\u003cmeta data-mint-head property=\"og:description\" content=\"The global leaderboard scoped to your own referred users: each row is that user\u0026#x27;s own referral standing (their referred count and referral earnings), keeping the global ranking. Only referred users who are themselves earning referrers appear. The response never carries a me block.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Limitless Exchange\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.limitless.exchange/api-reference/referral/leaderboard-friends\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://limitless.mintlify.site/_mintlify/api/og/v2?division=Referral\u0026amp;title=Get+Friends+Leaderboard\u0026amp;description=The+global+leaderboard+scoped+to+your+own+referred+users%3A+each+row+is+that+user%27s+own+referral+standing+%28their+referred+count+and+referral+earnings%29%2C+keeping+th\u0026amp;theme=888cee6df57f640d9a30d0c6\u0026amp;signature=020d9c485479fd5376c78e1bd066d97d42ddbd13ad830c61b6cbf20f630b25ba\">\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 Friends Leaderboard - Limitless Exchange\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The global leaderboard scoped to your own referred users: each row is that user\u0026#x27;s own referral standing (their referred count and referral earnings), keeping the global ranking. Only referred users who are themselves earning referrers appear. The response never carries a me block.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://limitless.mintlify.site/_mintlify/api/og/v2?division=Referral\u0026amp;title=Get+Friends+Leaderboard\u0026amp;description=The+global+leaderboard+scoped+to+your+own+referred+users%3A+each+row+is+that+user%27s+own+referral+standing+%28their+referred+count+and+referral+earnings%29%2C+keeping+th\u0026amp;theme=888cee6df57f640d9a30d0c6\u0026amp;signature=020d9c485479fd5376c78e1bd066d97d42ddbd13ad830c61b6cbf20f630b25ba\">\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/limitless/eKG_O-mKVQpNZHIN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Limitless Exchange\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9AB83A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.limitless.exchange/api-reference/referral/leaderboard-friends\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/referral/leaderboard-friends.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.limitless.exchange/#organization\",\"name\":\"Limitless Exchange\",\"url\":\"https://docs.limitless.exchange\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/limitless/r7gW3TwphUtCZ8zM/logo/light.svg?fit=max\u0026auto=format\u0026n=r7gW3TwphUtCZ8zM\u0026q=85\u0026s=0d6f32ed5e8a1f35ba9d1fa2e0b57a4b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.limitless.exchange#website\",\"name\":\"Limitless Exchange\",\"url\":\"https://docs.limitless.exchange\",\"publisher\":{\"@id\":\"https://docs.limitless.exchange/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.limitless.exchange/api-reference/referral/leaderboard-friends#webpage\",\"url\":\"https://docs.limitless.exchange/api-reference/referral/leaderboard-friends\",\"name\":\"Get Friends Leaderboard\",\"description\":\"The global leaderboard scoped to your own referred users: each row is that user's own referral standing (their referred count and referral earnings), keeping the global ranking. Only referred users who are themselves earning referrers appear. The response never carries a me block.\",\"dateModified\":\"2026-08-28T18:37:12.840Z\",\"isPartOf\":{\"@id\":\"https://docs.limitless.exchange#website\"},\"breadcrumb\":{\"@id\":\"https://docs.limitless.exchange/api-reference/referral/leaderboard-friends#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.limitless.exchange/api-reference/referral/leaderboard-friends#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Referral\",\"item\":\"https://docs.limitless.exchange/api-reference/referral/my-stats\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Friends Leaderboard\",\"item\":\"https://docs.limitless.exchange/api-reference/referral/leaderboard-friends\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.limitless.exchange/api-reference/referral/leaderboard-friends#apireference\",\"headline\":\"Get Friends Leaderboard\",\"name\":\"Get Friends Leaderboard\",\"description\":\"The global leaderboard scoped to your own referred users: each row is that user's own referral standing (their referred count and referral earnings), keeping the global ranking. Only referred users who are themselves earning referrers appear. The response never carries a me block.\",\"url\":\"https://docs.limitless.exchange/api-reference/referral/leaderboard-friends\",\"mainEntityOfPage\":{\"@id\":\"https://docs.limitless.exchange/api-reference/referral/leaderboard-friends#webpage\"},\"dateModified\":\"2026-08-28T18:37:12.840Z\",\"publisher\":{\"@id\":\"https://docs.limitless.exchange/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.limitless.exchange#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Limitless Exchange\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Limitless Exchange\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/referral/leaderboard-friends.md","siteName":"Limitless Exchange","nav":{"global":{"anchors":[{"anchor":"Limitless Exchange","icon":"arrow-up-right-from-square","href":"https://limitless.exchange"},{"anchor":"Builders Chat","icon":"telegram","href":"https://t.me/LimitlessBuildersChat"},{"anchor":"Discord","icon":"discord","href":"https://discord.com/invite/yb4SscD8RZ"},{"anchor":"Twitter","icon":"x-twitter","href":"https://x.com/trylimitless"}]},"tabs":[{"tab":"User Guide","pages":[{"title":"User Guide","href":""}]},{"tab":"For Developers","pages":[{"title":"For Developers","href":"/developers/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"System","pages":[{"title":"Maintenance Status","openapi":"GET /maintenance/status","href":"/api-reference/system/maintenance-status"}]},{"group":"Authentication","pages":[{"title":"User Logout","openapi":"POST /auth/logout","href":"/api-reference/auth/logout"},{"title":"Create API Key","openapi":"POST /auth/api-keys","href":"/api-reference/auth/create-api-key"},{"title":"Get Active API Key","openapi":"GET /auth/api-keys","href":"/api-reference/auth/get-api-key"},{"title":"Revoke API Key","openapi":"DELETE /auth/api-keys","href":"/api-reference/auth/revoke-api-key"}]},{"group":"Markets","pages":[{"title":"Browse Active Markets","openapi":"GET /markets/active","href":"/api-reference/markets/browse-active"},{"title":"Browse Active Markets by Category","openapi":"GET /markets/active/{categoryId}","href":"/api-reference/markets/browse-active-category"},{"title":"Get Category Counts","openapi":"GET /markets/categories/count","href":"/api-reference/markets/category-count"},{"title":"Get Active Market Slugs","openapi":"GET /markets/active/slugs","href":"/api-reference/markets/active-slugs"},{"title":"Market Timeline","href":"/api-reference/markets/timeline"},{"title":"Get Market Details","openapi":"GET /markets/{addressOrSlug}","href":"/api-reference/markets/get-market"},{"title":"Resolve Stable Slug","openapi":"GET /markets/stable/{slug}","href":"/api-reference/markets/resolve-stable-slug"},{"title":"Get Oracle Candlesticks","openapi":"GET /markets/{addressOrSlug}/oracle-candles","href":"/api-reference/markets/oracle-candles"},{"title":"Get Feed Events","openapi":"GET /markets/{slug}/get-feed-events","href":"/api-reference/markets/feed-events"},{"title":"Search Markets","openapi":"GET /markets/search","href":"/api-reference/markets/search"}]},{"group":"Packs","pages":[{"title":"List Packs","openapi":"GET /parlay/packs","href":"/api-reference/packs/list-packs"},{"title":"Search Active Packs","openapi":"GET /parlay/packs/search","href":"/api-reference/packs/search-packs"},{"title":"Get Pack","openapi":"GET /parlay/packs/{id}","href":"/api-reference/packs/get-pack"},{"title":"Quote Partner Pack","openapi":"POST /parlay/partner/quote","href":"/api-reference/packs/quote-pack"},{"title":"Buy Partner Pack","openapi":"POST /parlay/partner/buy","href":"/api-reference/packs/buy-pack"},{"title":"List Partner Pack Positions","openapi":"GET /parlay/partner/positions","href":"/api-reference/packs/list-positions"},{"title":"Get Partner Pack Position","openapi":"GET /parlay/partner/positions/{id}","href":"/api-reference/packs/get-position"},{"title":"Claim Partner Pack","openapi":"POST /parlay/partner/positions/{id}/claim","href":"/api-reference/packs/claim-position"},{"title":"Confirm Partner Pack Claim","openapi":"POST /parlay/partner/positions/{id}/claim/confirm","href":"/api-reference/packs/confirm-claim"}]},{"group":"Trading","pages":[{"title":"Create Order","openapi":"POST /orders","href":"/api-reference/trading/create-order"},{"title":"Get Order Status (Batch)","openapi":"POST /orders/status/batch","href":"/api-reference/trading/order-status-batch"},{"title":"Cancel Order (Combined)","openapi":"POST /orders/cancel","href":"/api-reference/trading/cancel"},{"title":"Batch Cancel Orders (Combined)","openapi":"POST /orders/batch-cancel","href":"/api-reference/trading/batch-cancel"},{"title":"Cancel and Replace Order","openapi":"POST /orders/cancel-replace","href":"/api-reference/trading/cancel-replace"},{"title":"Cancel and Replace Orders (Batch)","openapi":"POST /orders/cancel-replace/batch","href":"/api-reference/trading/cancel-replace-batch"},{"title":"Cancel Order","openapi":"DELETE /orders/{orderId}","href":"/api-reference/trading/cancel-order"},{"title":"Cancel Orders (Batch)","openapi":"POST /orders/cancel-batch","href":"/api-reference/trading/cancel-batch"},{"title":"Cancel All Orders","openapi":"DELETE /orders/all/{slug}","href":"/api-reference/trading/cancel-all"},{"title":"Market Maker Heartbeat","openapi":"POST /heartbeats","href":"/api-reference/trading/heartbeats"},{"title":"Get Orderbook","openapi":"GET /markets/{slug}/orderbook","href":"/api-reference/trading/orderbook"},{"title":"Get Historical Prices","openapi":"GET /markets/{slug}/historical-price","href":"/api-reference/trading/historical-price"},{"title":"Get User Orders","openapi":"GET /markets/{slug}/user-orders","href":"/api-reference/trading/user-orders"},{"title":"Get Market Events","openapi":"GET /markets/{slug}/events","href":"/api-reference/trading/market-events"}]},{"group":"Portfolio","pages":[{"title":"Get Current Profile","openapi":"GET /profiles/me","href":"/api-reference/portfolio/get-current-profile"},{"title":"Get Your Profile","openapi":"GET /profiles/{account}","href":"/api-reference/portfolio/get-profile"},{"title":"Get Trades","openapi":"GET /portfolio/trades","href":"/api-reference/portfolio/trades"},{"title":"Get Positions","openapi":"GET /portfolio/positions","href":"/api-reference/portfolio/positions"},{"title":"Redeem Resolved Positions","href":"/api-reference/portfolio/redeem"},{"title":"Split Collateral Into Outcome Set","href":"/api-reference/portfolio/split"},{"title":"Merge Outcome Set Into Collateral","href":"/api-reference/portfolio/merge"},{"title":"Withdraw From Server Wallet","href":"/api-reference/portfolio/withdraw"},{"title":"Add Withdrawal Address","href":"/api-reference/portfolio/add-withdrawal-address"},{"title":"Delete Withdrawal Address","href":"/api-reference/portfolio/delete-withdrawal-address"},{"title":"Get PnL Chart","openapi":"GET /portfolio/pnl-chart","href":"/api-reference/portfolio/pnl-chart"},{"title":"Get History","openapi":"GET /portfolio/history","href":"/api-reference/portfolio/history"},{"title":"Get Points Breakdown","openapi":"GET /portfolio/points","href":"/api-reference/portfolio/points"},{"title":"Get Trading Allowance","openapi":"GET /portfolio/trading/allowance","href":"/api-reference/portfolio/allowance"}]},{"group":"Market Pages \u0026 Navigation","pages":[{"title":"Get Navigation Tree","openapi":"GET /navigation","href":"/api-reference/navigation/get-navigation"},{"title":"Get Market Page by Path","openapi":"GET /market-pages/by-path","href":"/api-reference/navigation/get-page-by-path"},{"title":"List Markets for a Page","openapi":"GET /market-pages/{id}/markets","href":"/api-reference/navigation/list-page-markets"},{"title":"List Property Keys","openapi":"GET /property-keys","href":"/api-reference/navigation/list-property-keys"},{"title":"Get Property Key","openapi":"GET /property-keys/{id}","href":"/api-reference/navigation/get-property-key"},{"title":"List Property Options","openapi":"GET /property-keys/{id}/options","href":"/api-reference/navigation/list-property-options"}]},{"group":"API Tokens","pages":[{"title":"Get Partner Capabilities","openapi":"GET /auth/api-tokens/capabilities","href":"/api-reference/api-tokens/get-capabilities"},{"title":"Derive Scoped Token","openapi":"POST /auth/api-tokens/derive","href":"/api-reference/api-tokens/derive-token"},{"title":"List Active Tokens","openapi":"GET /auth/api-tokens","href":"/api-reference/api-tokens/list-tokens"},{"title":"Revoke Token","openapi":"DELETE /auth/api-tokens/{tokenId}","href":"/api-reference/api-tokens/revoke-token"}]},{"group":"Partner Accounts","pages":[{"title":"Create Partner Sub-Account","openapi":"POST /profiles/partner-accounts","href":"/api-reference/partner-accounts/create-partner-account"},{"title":"List Partner Sub-Accounts","openapi":"GET /profiles/partner-accounts","href":"/api-reference/partner-accounts/list-partner-accounts"},{"title":"Check Partner Account Allowances","openapi":"GET /profiles/partner-accounts/{profileId}/allowances","href":"/api-reference/partner-accounts/check-allowances"},{"title":"Retry Partner Account Allowances","openapi":"POST /profiles/partner-accounts/{profileId}/allowances/retry","href":"/api-reference/partner-accounts/retry-allowances"}]},{"group":"Public Portfolio","pages":[{"title":"Get User Traded Volume","openapi":"GET /portfolio/{account}/traded-volume","href":"/api-reference/public-portfolio/traded-volume"},{"title":"Get User Positions (Public)","openapi":"GET /portfolio/{account}/positions","href":"/api-reference/public-portfolio/positions"},{"title":"Get Realized PnL (Public)","openapi":"GET /portfolio/{account}/realized-pnl","href":"/api-reference/public-portfolio/realized-pnl"},{"title":"Get PnL Chart (Public)","openapi":"GET /portfolio/{account}/pnl-chart","href":"/api-reference/public-portfolio/pnl-chart"},{"title":"Get User History (Public)","openapi":"GET /portfolio/{account}/history","href":"/api-reference/public-portfolio/history"},{"title":"Get User Accuracy (Public)","openapi":"GET /user-stats/accuracy/{account}","href":"/api-reference/public-portfolio/accuracy"},{"title":"Get User Pack Positions (Public)","openapi":"GET /parlay/{account}/positions","href":"/api-reference/public-portfolio/pack-positions"}]},{"group":"Feed","pages":[{"title":"Get Trading Activity Feed","openapi":"GET /feed/trading","href":"/api-reference/feed/trading-feed"}]},{"group":"Referral","pages":[{"title":"Get My Referral Stats","openapi":"GET /referral/usdc/me","href":"/api-reference/referral/my-stats"},{"title":"Get My Referred Users","openapi":"GET /referral/usdc/referrals","href":"/api-reference/referral/my-referrals"},{"title":"Get Referral Leaderboard","openapi":"GET /referral/usdc/leaderboard","description":"The global referral leaderboard. Public - no authentication required. When the request is authenticated, the response additionally carries a `me` block pinning your own rank and entry even when outside the returned page.","href":"/api-reference/referral/leaderboard"},{"title":"Get Friends Leaderboard","openapi":"GET /referral/usdc/leaderboard/friends","href":"/api-reference/referral/leaderboard-friends"}]},{"group":"Leaderboard","pages":[{"title":"Unrealized PnL Leaderboard by Market","openapi":"GET /leaderboard/pnl/unrealized/markets/{marketId}","description":"Live leaderboard of open positions for one market, ranked by Unrealized PnL or ROI. Public - no authentication required. Ranks are absolute across pages, so page 2 with `limit=10` returns ranks 11-20.\n\nResults are paginated with `limit` (1-100, default 100) and `page` (1-100, default 1). The response also includes `totalRows` and `totalPages` describing the committed Top-100 generation for the market. `ETag` values are page-specific, so a validator returned for one page will not match another.\n\nResponses are served from a live Redis projection maintained by a dedicated worker. When the projection is warm the response is a `READY` snapshot with a strong `ETag` and short client cache. When the projection is still being rebuilt, callers may receive a `BUILDING`, `STALE`, or `DEGRADED` snapshot with `Cache-Control: no-store` and (for `BUILDING`) an empty `data` array - retry after a short delay. If the market is not open (`RESOLVED`, hidden, or otherwise ineligible), the endpoint returns `404`.","href":"/api-reference/leaderboard/unrealized-pnl-market"},{"title":"Biggest Open Positions","openapi":"GET /leaderboard/pnl/unrealized/biggest-positions","href":"/api-reference/leaderboard/biggest-positions"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Get Friends Leaderboard - Limitless Exchange","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}