> For the complete documentation index, see [llms.txt](https://noodles-finance.gitbook.io/docs.noodles.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://noodles-finance.gitbook.io/docs.noodles.fi/coin/coin-trending.md). # Coin Trends Retrieve a list of trending coins based on a given time period (last 30 minutes, 1 hour, 6 hours, 24 hours). The formular of trending coin please contact: [@hiephho](https://t.me/hiephho) ## Endpoint ```http POST /api/v1/partner/coin-trending ``` ## Request Body ### Parameters | Field | Type | Required | Description | | -------------- | ---------- | -------- | ------------------------------------------------------------------ | | `pagination` | `object` | No | Pagination | | ├─ `limit` | `number` | No | Max number of items to return. Default: `20`, Max: `200`. | | └─ `offset` | `number` | No | Index to start the results from. Default: `0`. | | `score_period` | `string` | Yes | Period trending score. Choices are: `30m`, `1h`, `4h`, `6h` `24h`. | | `filters` | `object` | No | Filters | | └─ `coin_ids` | `string[]` | No | Array of coin\_id to filter (use to filter favorite coins). | ### Example ```json { "pagination": { "limit": 10, "offset": 0 }, "score_period": "24h", "filters": { "coin_ids": [ "0x32a976482bf4154961bf20bfa3567a80122fdf8e8f8b28d752b609d8640f7846::miu::MIU", "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP" ] } } ``` ## Headers | Header | Required | Description | | ----------- | -------- | --------------------------- | | `x-api-key` | No | API key for authentication. | ## Response Body ### Fields | Field | Type | Description | | ----------------------- | --------- | ------------------------------------------------------ | | `data` | `array` | List of trending coin objects. | | ├─ `coin_type` | `string` | Coin Identifier | | ├─ `name` | `string` | Name of the coin. | | ├─ `symbol` | `string` | Symbol of the coin. | | ├─ `logo` | `string` | URL to the coin's logo. | | ├─ `price` | `number` | Current price of the coin. | | ├─ `price_change_1d` | `number` | % price change in the last 24 hours. | | ├─ `price_change_6h` | `number` | % price change in the last 6 hours. | | ├─ `price_change_4h` | `number` | % price change in the last 4 hours. | | ├─ `price_change_1h` | `number` | % price change in the last hour. | | ├─ `price_change_30m` | `number` | % price change in the last 30 minutes. | | ├─ `vol_change_1d` | `number` | % volume change in the last 24 hours. | | ├─ `liq_change_1d` | `number` | % liquidity of coin (usd) change in the last 24 hours. | | ├─ `tx_change_1d` | `number` | % Number of transactions change in the last 24 hours. | | ├─ `tx_24h` | `number` | Number of transactions in 24h. | | ├─ `volume_24h` | `number` | Trading volume in 24h. | | ├─ `volume_6h` | `number` | Trading volume in 6h. | | ├─ `volume_4h` | `number` | Trading volume in 4h. | | ├─ `volume_1h` | `number` | Trading volume in 1h. | | ├─ `volume_30m` | `number` | Trading volume in 30 minutes. | | ├─ `maker_24h` | `number` | Number of makers in 24h. | | ├─ `market_cap` | `string` | Market cap. | | ├─ `liquidity_usd` | `string` | Liquidity in USD. | | ├─ `circulating_supply` | `string` | Circulating supply. | | ├─ `total_supply` | `string` | Total coin supply. | | ├─ `published_at` | `string` | Created time of the coin (RFC3339 format). | | ├─ `verified` | `boolean` | Indicates if the coin is verified by Blockvision. | | └─ `decimals` | `number` | Number of decimals for the coin. | | `pagination` | `object` | Pagination object (limit & offset). | ### Success Response ```json { "code": 200, "message": "OK", "data": [ { "coin_type": "0xb2d912e4f100e03b7de58d874835e358dc2802f2fb8559f56a70a7c900f8fc78::jug_sui::JUG_SUI", "name": "Jugemu Sui", "symbol": "jugSUI", "logo": "https://liqag.wal.app/lsts/jugSUI.png", "price": 3.513, "price_change_1d": 2.02, "price_change_6h": 1.24, "price_change_4h": 2.37, "price_change_1h": -1.97, "price_change_30m": -0.7, "vol_change_1d": -39.92, "liq_change_1d": 1.86, "tx_change_1d": -35.61, "tx_24h": 810, "volume_24h": 96673.77, "volume_6h": 47946.02, "volume_4h": 41737.91, "volume_1h": 12345.67, "volume_30m": 7771.5, "maker_24h": 283, "market_cap": "0", "liquidity_usd": "34842.06", "circulating_supply": "0", "total_supply": "0", "published_at": "2025-04-21T23:07:40.803Z", "verified": true, "rank": 1, "decimals": 9 }, { "coin_type": "0x7262fb2f7a3a14c888c438a3cd9b912469a58cf60f367352c46584262e8299aa::ika::IKA", "name": "IKA Token", "symbol": "IKA", "logo": "https://token-logos.noodles.fi/ika.svg", "price": 0.0368, "price_change_1d": -3.3, "price_change_6h": -2.66, "price_change_4h": 0.14, "price_change_1h": -4.05, "price_change_30m": -2.05, "vol_change_1d": 6.67, "liq_change_1d": -3.25, "tx_change_1d": -12.62, "tx_24h": 11221, "volume_24h": 7317387.53, "volume_6h": 2836299.83, "volume_4h": 2287841.14, "volume_1h": 368241.21, "volume_30m": 235308.84, "maker_24h": 1561, "market_cap": "368232714.29", "liquidity_usd": "2838833.38", "circulating_supply": "10000000000", "total_supply": "10000000000", "published_at": "2025-07-16T14:25:36.944Z", "verified": true, "rank": 2, "decimals": 9 } ], "pagination": { "offset": 0, "limit": 2 } } ``` > **See also:** [Environment Setup](/docs.noodles.fi/environment-setup/environment.md) --- # 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://noodles-finance.gitbook.io/docs.noodles.fi/coin/coin-trending.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.