> For the complete documentation index, see [llms.txt](https://docs.fyuz.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fyuz.fun/api-reference/discovery-and-analytics.md).
# Discovery & Analytics
The screener behind Discover, per-token safety analytics and top-trader leaderboards.
## Screener
> The query behind the Discover page — Trending / New / Gainers / About-to-Graduate tabs plus market-cap, volume, holder, age and status filters.
```json
{"openapi":"3.1.0","info":{"title":"Fyuz API","version":"1.0.0"},"tags":[{"name":"Discovery & Analytics","description":"The screener behind Discover, per-token safety analytics and top-trader leaderboards."}],"servers":[{"url":"https://api.fyuz.fun","description":"Production"}],"paths":{"/discover":{"get":{"tags":["Discovery & Analytics"],"summary":"Screener","description":"The query behind the Discover page — Trending / New / Gainers / About-to-Graduate tabs plus market-cap, volume, holder, age and status filters.\n","operationId":"discover","parameters":[{"name":"tab","in":"query","schema":{"type":"string","enum":["trending","new","gainers","graduating"]}},{"name":"min_marketcap","in":"query","schema":{"type":"number"}},{"name":"min_volume","in":"query","schema":{"type":"number"}},{"name":"min_holders","in":"query","schema":{"type":"integer"}},{"name":"max_age_secs","in":"query","schema":{"type":"integer"}},{"name":"status","in":"query","schema":{"type":"string","enum":["bonding","graduated"]}}],"responses":{"200":{"description":"Matching tokens.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Token"}}}}}}}}},"components":{"schemas":{"Token":{"type":"object","properties":{"address":{"type":"string"},"network":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"description":{"type":"string"},"image":{"type":"string","description":"The fused character image."},"creator":{"type":"string"},"price":{"type":"number"},"marketcap":{"type":"number"},"graduationPercent":{"type":"number"},"launched":{"type":"boolean","description":"True once graduated to PancakeSwap."},"isLive":{"type":"boolean","description":"True while the creator is streaming."},"createdAt":{"type":"string"}}}}}}
```
## Token analytics
> Safety read-out for a token — holder count, top-10 holder concentration, creator holdings %, buy/sell pressure, creation-bundle flag and graduation progress.
```json
{"openapi":"3.1.0","info":{"title":"Fyuz API","version":"1.0.0"},"tags":[{"name":"Discovery & Analytics","description":"The screener behind Discover, per-token safety analytics and top-trader leaderboards."}],"servers":[{"url":"https://api.fyuz.fun","description":"Production"}],"paths":{"/analytics/{network}/{address}":{"get":{"tags":["Discovery & Analytics"],"summary":"Token analytics","description":"Safety read-out for a token — holder count, top-10 holder concentration, creator holdings %, buy/sell pressure, creation-bundle flag and graduation progress.\n","operationId":"tokenAnalytics","parameters":[{"$ref":"#/components/parameters/network"},{"$ref":"#/components/parameters/address"}],"responses":{"200":{"description":"Analytics panel data.","content":{"application/json":{"schema":{"type":"object","properties":{"holders":{"type":"integer"},"top10Percent":{"type":"number","description":"Share of supply held by the top 10 wallets."},"creatorPercent":{"type":"number","description":"Share of supply held by the creator."},"buys":{"type":"integer"},"sells":{"type":"integer"},"bundled":{"type":"boolean","description":"Multiple buys detected at creation (snipe signature)."},"graduationPercent":{"type":"number"}}}}}}}}}},"components":{"parameters":{"network":{"name":"network","in":"path","required":true,"schema":{"type":"string"},"description":"Chain identifier as used by the app."},"address":{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Wallet or token address (hex)."}}}}
```
## Top traders for a token
> Per-token PnL leaderboard with wallet labels (creator, whale).
```json
{"openapi":"3.1.0","info":{"title":"Fyuz API","version":"1.0.0"},"tags":[{"name":"Discovery & Analytics","description":"The screener behind Discover, per-token safety analytics and top-trader leaderboards."}],"servers":[{"url":"https://api.fyuz.fun","description":"Production"}],"paths":{"/analytics/top-traders/{network}/{address}":{"get":{"tags":["Discovery & Analytics"],"summary":"Top traders for a token","description":"Per-token PnL leaderboard with wallet labels (creator, whale).","operationId":"topTraders","parameters":[{"$ref":"#/components/parameters/network"},{"$ref":"#/components/parameters/address"}],"responses":{"200":{"description":"Ranked traders.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"pnl":{"type":"number"},"label":{"type":"string","description":"creator / whale / empty."}}}}}}}}}}},"components":{"parameters":{"network":{"name":"network","in":"path","required":true,"schema":{"type":"string"},"description":"Chain identifier as used by the app."},"address":{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Wallet or token address (hex)."}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.fyuz.fun/api-reference/discovery-and-analytics.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.