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. Default: published_at.

order_direction

string

No

Sort direction: asc or desc. Default: desc.

filters

object

No

Filtering criteria. See 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.

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

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

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

Last updated