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/coinsHeaders
x-api-key
Yes
API key for authorization.
Request Body
The request body is a JSON object with the following top-level fields:
pagination
object
No
Pagination settings. Defaults to { "offset": 0, "limit": 20 }.
order_direction
string
No
Sort direction: asc or desc. Default: desc.
Pagination Object
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
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
protocol
string[]
Filter by bonding curve protocol identifiers. Max 100 items.
See 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
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
code
number
No
HTTP status code.
message
string
No
Response message.
data
array
No
List of coin objects.
Coin Object
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 satisfymin <= maxwhen both are provided.bonding_curve_progressrepresents the percentage of tokens sold through the bonding curve before graduation to a DEX. When it reaches 100%, the coin graduates.graduated_timeisnullfor coins still on the bonding curve.Sorting by
graduated_timeis only meaningful when filtering for graduated coins (is_graduated: true).
See also: Environment Setup
Last updated