> 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/curve-coin-list.md). # Curve Coin List Retrieve a list of bonding curve coins with advanced filtering, sorting, and pagination support. This endpoint returns token metadata, market data, holder information, and social links for coins launched on supported bonding curve protocols. ## Endpoint ``` POST /api/v1/partner/curve/coins ``` ## Headers | Header | Required | Description | | ----------- | -------- | -------------------------- | | `x-api-key` | Yes | API key for authorization. | ## Request Body The request body is a JSON object with the following top-level fields: | Field | Type | Required | Description | | ----------------- | ------ | -------- | ----------------------------------------------------------------------------------- | | `pagination` | object | No | Pagination settings. Defaults to `{ "offset": 0, "limit": 20 }`. | | `order_by` | string | No | Field to sort by. See [Order By Values](#order-by-values). Default: `published_at`. | | `order_direction` | string | No | Sort direction: `asc` or `desc`. Default: `desc`. | | `filters` | object | No | Filtering criteria. See [Filter Fields](#filter-fields). | ### Pagination Object | Field | Type | Required | Description | | -------- | ------ | -------- | -------------------------------------------------------------------------- | | `offset` | number | No | Number of records to skip before starting to return results. Default: `0`. | | `limit` | number | No | Maximum number of records to return. Default: `20`. | ### Order By Values | Value | Description | | ------------------------ | -------------------------------------------------- | | `published_at` | Sort by the time the coin was published (default). | | `bonding_curve_progress` | Sort by bonding curve completion percentage. | | `graduated_time` | Sort by the time the coin graduated. | ### Filter Fields | Field | Type | Description | Constraints | | ---------------------------- | --------- | --------------------------------------------------------------------------- | ------------------------------------------------ | | `protocol` | string\[] | Filter by bonding curve protocol identifiers. Max 100 items. | See [Supported Protocols](#supported-protocols). | | `coin_ids` | string\[] | Filter by specific coin type identifiers. Max 1000 items. | | | `dev_address` | string | Filter by the developer's wallet address. | | | `is_graduated` | boolean | Filter by graduation status (`true` = graduated, `false` = still on curve). | | | `at_least_1_social_link` | boolean | Only return coins that have at least one social media link. | | | `has_x` | boolean | Filter by whether the coin has an X (Twitter) link. | | | `has_telegram` | boolean | Filter by whether the coin has a Telegram link. | | | `has_website` | boolean | Filter by whether the coin has a website. | | | `dev_sell_all` | boolean | Filter by whether the developer has sold all their tokens. | | | `dev_still_holding` | boolean | Filter by whether the developer is still holding tokens. | | | `top_10_holding_percent_min` | number | Minimum percentage held by the top 10 holders. | Range: `[0, 100]` | | `top_10_holding_percent_max` | number | Maximum percentage held by the top 10 holders. | Range: `[0, 100]` | | `dev_holding_percent_min` | number | Minimum percentage held by the developer. | Range: `[0, 100]` | | `dev_holding_percent_max` | number | Maximum percentage held by the developer. | Range: `[0, 100]` | | `sniper_holding_percent_min` | number | Minimum percentage held by snipers. | Range: `[0, 100]` | | `sniper_holding_percent_max` | number | Maximum percentage held by snipers. | Range: `[0, 100]` | | `holders_min` | integer | Minimum number of holders. | `>= 0` | | `holders_max` | integer | Maximum number of holders. | `>= 0` | | `market_cap_min` | number | Minimum market cap in USD. | `>= 0` | | `market_cap_max` | number | Maximum market cap in USD. | `>= 0` | | `bonding_curve_progress_min` | number | Minimum bonding curve completion percentage. | Range: `[0, 100]` | | `bonding_curve_progress_max` | number | Maximum bonding curve completion percentage. | Range: `[0, 100]` | | `volume_24h_min` | number | Minimum 24-hour trading volume in USD. | `>= 0` | | `volume_24h_max` | number | Maximum 24-hour trading volume in USD. | `>= 0` | | `txs_24h_min` | integer | Minimum number of transactions in the last 24 hours. | `>= 0` | | `txs_24h_max` | integer | Maximum number of transactions in the last 24 hours. | `>= 0` | | `txs_buy_24h_min` | integer | Minimum number of buy transactions in the last 24 hours. | `>= 0` | | `txs_buy_24h_max` | integer | Maximum number of buy transactions in the last 24 hours. | `>= 0` | | `txs_sell_24h_min` | integer | Minimum number of sell transactions in the last 24 hours. | `>= 0` | | `txs_sell_24h_max` | integer | Maximum number of sell transactions in the last 24 hours. | `>= 0` | ### Supported Protocols | Protocol Identifier | Description | | -------------------------- | ------------------------ | | `7k-fun-bonding-curve` | 7k Fun bonding curve | | `moonbags-bonding-curve` | Moonbags bonding curve | | `movepump-bonding-curve` | MovePump bonding curve | | `turbos-fun-bonding-curve` | Turbos Fun bonding curve | | `blast-fun-bonding-curve` | Blast Fun bonding curve | | `mfc-bonding-curve` | MFC bonding curve | ## cURL Example ```bash curl --location 'https://api.noodles.fi/api/v1/partner/curve/coins' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' \ --data '{ "pagination": { "offset": 0, "limit": 20 }, "order_by": "published_at", "order_direction": "desc", "filters": { "protocol": ["blast-fun-bonding-curve"], "is_graduated": false, "holders_min": 10, "volume_24h_min": 1000 } }' ``` ## Response ### Fields | Field | Type | Nullable | Description | | --------- | ------ | -------- | --------------------- | | `code` | number | No | HTTP status code. | | `message` | string | No | Response message. | | `data` | array | No | List of coin objects. | ### Coin Object | Field | Type | Nullable | Description | | ------------------------ | ------- | -------- | -------------------------------------------------------------------------------------------------- | | `coin_type` | string | No | Unique identifier of the coin. | | `name` | string | No | Full name of the coin. | | `symbol` | string | No | Token symbol. | | `icon_url` | string | No | URL to the token's icon image. | | `txs_24h` | integer | No | Total number of transactions in the last 24 hours. | | `txs_sell_24h` | integer | No | Number of sell transactions in the last 24 hours. | | `txs_buy_24h` | integer | No | Number of buy transactions in the last 24 hours. | | `holders` | integer | No | Current number of token holders. | | `dev_holdings` | number | No | Percentage of supply held by the developer. | | `sniper_holdings` | number | No | Percentage of supply held by snipers. | | `top10_holdings` | number | No | Percentage of supply held by the top 10 holders. | | `volume_24h` | number | No | 24-hour trading volume in USD. | | `market_cap` | number | No | Current market capitalization in USD. | | `liquidity` | number | No | Current liquidity in USD. | | `published_at` | string | No | ISO 8601 timestamp of when the coin was launched. | | `protocol` | string | No | Bonding curve protocol identifier the coin belongs to. | | `protocol_url` | string | No | URL to the coin's page on the protocol platform. | | `bonding_curve_progress` | number | No | Completion percentage of the bonding curve (0–100). | | `bonding_curve_pool_id` | string | Yes | Pool identifier on the bonding curve. | | `is_anti_sniper` | boolean | Yes | Whether the coin has anti-sniper protection enabled. | | `graduated_time` | string | Yes | ISO 8601 timestamp of when the coin graduated from the bonding curve. `null` if not yet graduated. | | `decimals` | integer | No | Number of decimal places for the token. | | `social_media` | object | No | Social media links associated with the coin. | ### Success Response Example ```json { "code": 200, "message": "OK", "data": [ { "coin_type": "0xe50f7a85a59e8a12a4891471cf415e37a0fde68ec44cc17f2c500c3ec596c6a6::snap::SNAP", "name": "Baby Snap", "symbol": "SNAP", "icon_url": "https://statics.noodles.fi/logo/2007676354108832011.jpg", "txs_24h": 0, "txs_sell_24h": 0, "txs_buy_24h": 0, "holders": 5, "dev_holdings": 2.32, "sniper_holdings": 0, "top10_holdings": 4.89, "volume_24h": 0, "market_cap": 993.27, "liquidity": 758.45, "published_at": "2026-02-22T23:25:15.692Z", "protocol": "blast-fun-bonding-curve", "protocol_url": "https://blast.fun/token/0x7f372fcdd9ff8de79119e1a417bf4694cce7de4f2539e6dbc255aa684c68da36", "bonding_curve_progress": 6.71, "bonding_curve_pool_id": "0x7f372fcdd9ff8de79119e1a417bf4694cce7de4f2539e6dbc255aa684c68da36", "is_anti_sniper": true, "decimals": 9, "social_media": { "x": "HTTPS://x.com/babysnapsui" } }, { "coin_type": "0xcfbb8573f617d05fb5883c4c113813051435cffc0ff65ebed193d740fed0779f::dora::DORA", "name": "SUI BLOCK EXPLORER", "symbol": "DORA", "icon_url": "https://statics.noodles.fi/logo/8577706133898470868.jpg", "txs_24h": 0, "txs_sell_24h": 0, "txs_buy_24h": 0, "holders": 1, "dev_holdings": 0.02, "sniper_holdings": 0, "top10_holdings": 0.02, "volume_24h": 0, "market_cap": 557.21, "liquidity": 454.13, "published_at": "2026-02-15T19:17:15.847Z", "protocol": "blast-fun-bonding-curve", "protocol_url": "https://blast.fun/token/0x6fb8fee86c6fa562e0cf88aaef2b46ef62c764934bca34146987c4ac8441f672", "bonding_curve_progress": 0, "bonding_curve_pool_id": "0x6fb8fee86c6fa562e0cf88aaef2b46ef62c764934bca34146987c4ac8441f672", "is_anti_sniper": true, "decimals": 9, "social_media": {} } ] } ``` ## Notes * All range filter pairs (e.g., `holders_min` / `holders_max`) must satisfy `min <= max` when both are provided. * `bonding_curve_progress` represents the percentage of tokens sold through the bonding curve before graduation to a DEX. When it reaches 100%, the coin graduates. * `graduated_time` is `null` for coins still on the bonding curve. * Sorting by `graduated_time` is only meaningful when filtering for graduated coins (`is_graduated: true`). *** > **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/curve-coin-list.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.