> 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-new.md). # Coin New Retrieve a list of new coins based on their published time. Note: * Only coins published in the **last 30 days** are visible * Only coins have liquidity pool on at least one DEX are visible ## Endpoint ```http POST /api/v1/partner/coin-new ``` ## Request Body ### Parameters | Field | Type | Required | Description | | ------------------------- | ---------- | -------- | ----------------------------------------------------------- | | `pagination` | `object` | No | Pagination settings | | ├─ `limit` | `number` | No | Max number of items to return. Default: `20`, Max: `200`. | | └─ `offset` | `number` | No | Index to start the results from. Default: `0`. | | `filters` | `object` | No | Filter criteria | | ├─ `coin_ids` | `string[]` | No | Array of coin\_id to filter (use to filter favorite coins). | | ├─ `min_market_cap` | `number` | No | Minimum market cap filter. | | ├─ `max_market_cap` | `number` | No | Maximum market cap filter. | | ├─ `min_liquidity` | `number` | No | Minimum liquidity (USD) filter. | | ├─ `max_liquidity` | `number` | No | Maximum liquidity (USD) filter. | | ├─ `min_volume` | `number` | No | Minimum 24h volume filter. | | ├─ `max_volume` | `number` | No | Maximum 24h volume filter. | | ├─ `min_holder` | `number` | No | Minimum number of holders. | | ├─ `max_holder` | `number` | No | Maximum number of holders. | | ├─ `min_price_24h_change` | `number` | No | Minimum 24h price change percentage. | | ├─ `max_price_24h_change` | `number` | No | Maximum 24h price change percentage. | | ├─ `min_tx_buy_24h` | `number` | No | Minimum buy transactions in 24h. | | ├─ `max_tx_buy_24h` | `number` | No | Maximum buy transactions in 24h. | | ├─ `min_tx_sell_24h` | `number` | No | Minimum sell transactions in 24h. | | ├─ `max_tx_sell_24h` | `number` | No | Maximum sell transactions in 24h. | | ├─ `min_tx_24h` | `number` | No | Minimum total transactions in 24h. | | ├─ `max_tx_24h` | `number` | No | Maximum total transactions in 24h. | | ├─ `publish_at_from` | `string` | No | Filter coins published from this date (ISO 8601 format). | | ├─ `publish_at_to` | `string` | No | Filter coins published until this date (ISO 8601 format). | | ├─ `has_social` | `boolean` | No | Filter coins with any social links. | | ├─ `verified` | `boolean` | No | Filter by verification status. | ### Example Request ```bash curl --location 'https://api.noodles.fi/api/v1/partner/coin-new' \ --header 'Accept-Encoding: application/json' \ --header 'x-api-key: ' \ --header 'Content-Type: application/json' \ --data '{ "pagination": { "offset": 0, "limit": 40 }, "filters": { "publish_at_from": "2025-12-08T00:00:00Z", "min_liquidity": 1 } }' ``` ## 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_1h` | `number` | % price change in the last hour. | | ├─ `price_change_6h` | `number` | % price change in the last 6 hours. | | ├─ `price_change_1d` | `number` | % price change in the last 24 hours. | | ├─ `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 { "data": [ { "coin_type": "0xb06a3f707841a749ffb421660d020f9f995cba77f60871db46d425d1c8f54c9f::popepe::POPEPE", "name": "Vatican New Pope", "symbol": "POPEPE", "logo": "https://dd.dexscreener.com/ds-data/tokens/solana/GiGfQSPdzEvtggnzN8YHwB56EoeAYDyRsdfe5d22pump.png?size=lg&key=1cfc1c", "price": 0.00002214, "price_change_1h": 0, "price_change_6h": 0, "price_change_1d": 2.65, "vol_change_1d": 10.2, "liq_change_1d": 0, "tx_change_1d": 0, "tx_24h": 0, "volume_24h": 0, "volume_6h": 0, "volume_4h": 0, "volume_1h": 0, "volume_30m": 0, "maker_24h": 0, "market_cap": "0", "liquidity_usd": "0", "circulating_supply": "0", "total_supply": "0", "published_at": "2025-04-21T08:39:20.777Z", "verified": false, "decimals": 9 }, { "coin_type": "0xb4604e1101a2a696a20f9a1e53518c2c3dbb06614f8d65e31b88f81af7169733::groksui::GROKSUI", "name": "GROKSUI", "symbol": "GROKSUI", "logo": "https://movepump.com/_next/image?url=https%3A%2F%2Fapi.movepump.com%2Fuploads%2F0_G_Roke_robot_surfing_f7994d3dae.png&w=640&q=75", "price": 0.0000234, "price_change_1h": 0, "price_change_6h": 0, "price_change_1d": 117.58, "vol_change_1d": 0, "liq_change_1d": 3.12, "tx_change_1d": 0, "tx_24h": 0, "volume_24h": 0, "volume_6h": 0, "volume_4h": 0, "volume_1h": 0, "volume_30m": 0, "maker_24h": 0, "market_cap": "0", "liquidity_usd": "0", "circulating_supply": "0", "total_supply": "0", "published_at": "2025-04-21T01:59:13.777Z", "verified": false, "decimals": 9 } ], "pagination": { "limit": 2, "offset": 0 } } ``` > **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-new.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.