> 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/tokens-and-markets.md).
# Tokens & Markets
Token listings, detail, charts, trades and the King of the Hill.
## List tokens
> Paginated token list. \`order\_type\` supports \`createdAt\`, \`trends\` (time-decayed activity score), \`bump\`, \`marketcap\`, \`volume\`, \`holders\`, \`graduation\` and \`gainers\`.
```json
{"openapi":"3.1.0","info":{"title":"Fyuz API","version":"1.0.0"},"tags":[{"name":"Tokens & Markets","description":"Token listings, detail, charts, trades and the King of the Hill."}],"servers":[{"url":"https://api.fyuz.fun","description":"Production"}],"paths":{"/tokens":{"get":{"tags":["Tokens & Markets"],"summary":"List tokens","description":"Paginated token list. `order_type` supports `createdAt`, `trends` (time-decayed activity score), `bump`, `marketcap`, `volume`, `holders`, `graduation` and `gainers`.\n","operationId":"listTokens","parameters":[{"name":"order_type","in":"query","schema":{"type":"string","enum":["createdAt","trends","bump","marketcap","volume","holders","graduation","gainers"]}},{"name":"network","in":"query","schema":{"type":"string"}},{"name":"search_word","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","enum":["bonding","graduated"]}},{"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":"page","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"A page of 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"}}}}}}
```
## Get one token
> Full detail for one token — metadata, reserves, price, market cap and graduation progress.
```json
{"openapi":"3.1.0","info":{"title":"Fyuz API","version":"1.0.0"},"tags":[{"name":"Tokens & Markets","description":"Token listings, detail, charts, trades and the King of the Hill."}],"servers":[{"url":"https://api.fyuz.fun","description":"Production"}],"paths":{"/tokens/token/{network}/{address}":{"get":{"tags":["Tokens & Markets"],"summary":"Get one token","description":"Full detail for one token — metadata, reserves, price, market cap and graduation progress.","operationId":"getToken","parameters":[{"$ref":"#/components/parameters/network"},{"$ref":"#/components/parameters/address"}],"responses":{"200":{"description":"The token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Token"}}}}}}}},"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)."}},"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"}}}}}}
```
## Current King of the Hill
> The highest-market-cap token still trading on the bonding curve.
```json
{"openapi":"3.1.0","info":{"title":"Fyuz API","version":"1.0.0"},"tags":[{"name":"Tokens & Markets","description":"Token listings, detail, charts, trades and the King of the Hill."}],"servers":[{"url":"https://api.fyuz.fun","description":"Production"}],"paths":{"/tokens/king":{"get":{"tags":["Tokens & Markets"],"summary":"Current King of the Hill","description":"The highest-market-cap token still trading on the bonding curve.","operationId":"getKing","responses":{"200":{"description":"The reigning token.","content":{"application/json":{"schema":{"$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"}}}}}}
```
## Chart data
> OHLC candle series for the token page chart.
```json
{"openapi":"3.1.0","info":{"title":"Fyuz API","version":"1.0.0"},"tags":[{"name":"Tokens & Markets","description":"Token listings, detail, charts, trades and the King of the Hill."}],"servers":[{"url":"https://api.fyuz.fun","description":"Production"}],"paths":{"/tokens/getChartData":{"get":{"tags":["Tokens & Markets"],"summary":"Chart data","description":"OHLC candle series for the token page chart.","operationId":"getChartData","parameters":[{"name":"token","in":"query","schema":{"type":"string"},"description":"Token address."},{"name":"resolution","in":"query","schema":{"type":"string"},"description":"Candle resolution."}],"responses":{"200":{"description":"Candle series.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}}}
```
## Recent trades
> Latest trades across the platform — feeds the live activity ticker.
```json
{"openapi":"3.1.0","info":{"title":"Fyuz API","version":"1.0.0"},"tags":[{"name":"Tokens & Markets","description":"Token listings, detail, charts, trades and the King of the Hill."}],"servers":[{"url":"https://api.fyuz.fun","description":"Production"}],"paths":{"/trades/recent":{"get":{"tags":["Tokens & Markets"],"summary":"Recent trades","description":"Latest trades across the platform — feeds the live activity ticker.","operationId":"recentTrades","responses":{"200":{"description":"Recent trades.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Trade"}}}}}}}}},"components":{"schemas":{"Trade":{"type":"object","properties":{"token":{"type":"string"},"trader":{"type":"string"},"side":{"type":"string","enum":["buy","sell"]},"bnbAmount":{"type":"number"},"tokenAmount":{"type":"number"},"price":{"type":"number"},"txHash":{"type":"string"},"tradedAt":{"type":"string"}}}}}}
```
## Trade history
> Trade history, filterable per token or per wallet, paginated.
```json
{"openapi":"3.1.0","info":{"title":"Fyuz API","version":"1.0.0"},"tags":[{"name":"Tokens & Markets","description":"Token listings, detail, charts, trades and the King of the Hill."}],"servers":[{"url":"https://api.fyuz.fun","description":"Production"}],"paths":{"/trades/history":{"get":{"tags":["Tokens & Markets"],"summary":"Trade history","description":"Trade history, filterable per token or per wallet, paginated.","operationId":"tradeHistory","parameters":[{"name":"token","in":"query","schema":{"type":"string"}},{"name":"address","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Trades.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Trade"}}}}}}}}},"components":{"schemas":{"Trade":{"type":"object","properties":{"token":{"type":"string"},"trader":{"type":"string"},"side":{"type":"string","enum":["buy","sell"]},"bnbAmount":{"type":"number"},"tokenAmount":{"type":"number"},"price":{"type":"number"},"txHash":{"type":"string"},"tradedAt":{"type":"string"}}}}}}
```
---
# 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/tokens-and-markets.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.