Coin Details

Retrieve detailed information about a specific coin, including token metadata, market data, social links, security insights, and price changes.

---

Endpoint

GET /api/v1/partner/coin-detail

Parameters

GET Request Parameters

Name	Type	Required	Description
coin_id	string	Yes	The unique identifier of the coin (e.g., 0x...::module::COIN).

Headers

Header	Required	Description
x-api-key	Yes	API key for authorization.
x-chain	Yes	Blockchain identifier (e.g., sui).

---

cURL Example

curl --location 'https://api.noodles.fi/api/v1/partner/coin-detail?coin_id=0xb45fcfcc2cc07ce0702cc2d229621e046c906ef14d9b25e8e4d25f6e8763fef7::send::SEND' \
--header 'Accept-Encoding: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'x-chain: sui'

---

Response

Field

Field	Type	Nullable	Description
code	number	No	HTTP status code.
message	string	No	Response message.
data	object	No	Coin detail object.

Coin Detail Object

Field	Type	Nullable	Description
coin	object	No	Basic metadata about the coin.
price_change	object	No	Current price and change over time.
social_media	object	Yes	Social and resource links.
tags	array	Yes	Array of tag objects.
rank	number	Yes	Market rank or internal project rank.
security	object	Yes	Token security and concentration data.
bonding_curve_info	object	Yes	Bonding curve metadata for launchpad-style tokens.

Coin Object

Field	Type	Nullable	Description
coin_type	string	No	Unique identifier of the coin.
symbol	string	No	Symbol of the coin.
name	string	No	Name of the coin.
logo	string	Yes	URL to the coin's logo image.
description	string	Yes	Description of the coin/project.
liquidity	string	Yes	Current liquidity in USD.
market_cap	string	Yes	Market capitalization in USD.
fdv	string	Yes	Fully Diluted Valuation.
circulating_supply	string	Yes	Circulating supply of the token.
total_supply	string	Yes	Total supply of the token.
holders	number	Yes	Total number of holders.
creator	string	Yes	Address of the creator.
published_at	string	Yes	Deployment time of the coin (RFC3339 format).
verified	boolean	No	Whether the project is verified.
decimals	number	Yes	Number of decimals for the token.

Price Change Object

Field	Type	Nullable	Description
price	string	No	Current price in USD.
price_change_1h	number	Yes	% price change in the last 1 hour.
price_change_6h	number	Yes	% price change in the last 6 hours.
price_change_1d	number	Yes	% price change in the last 24 hours.
price_change_7d	number	Yes	% price change in the last 7 days.
price_24h_low	string	Yes	Lowest price in the last 24 hours.
price_24h_high	string	Yes	Highest price in the last 24 hours.
ath	string	Yes	All-time high price.
atl	string	Yes	All-time low price.

Social Media Object

Field	Type	Nullable	Description
x	string	Yes	X (formerly Twitter) profile URL.
website	string	Yes	Official website.
discord	string	Yes	Discord server invite link.
coingecko_url	string	Yes	CoinGecko profile URL.
coinmarketcap_url	string	Yes	CoinMarketCap profile URL.
docs	string	Yes	Project documentation URL.

Tags Object

Field	Type	Nullable	Description
id	number	No	Tag identifier.
name	string	No	Human-readable tag name.

Security Object

We use the gopluslabs data to provide security insights for the token. Please consider this data as a reference and not as a definitive security assessment. The security object contains the following fields:

Field	Type	Nullable	Description
mintable	boolean	No	Indicates if the token is mintable.
blacklist	boolean	No	Indicates if blacklist functionality exists.
top_10_holders	number	Yes	% of supply held by top 10 holders.

Bonding Curve Info Object

The bonding_curve_info object contains launchpad bonding curve details when available.

Field	Type	Nullable	Description
protocol_url	string	Yes	URL to the protocol page for the pool/token.
bonding_curve_progress	number	Yes	Bonding curve completion percentage.
payment_coin_collected	string	Yes	Amount of payment coin collected so far.
payment_coin_left	string	Yes	Remaining payment coin required to reach target liquidity.
payment_coin_id	string	Yes	Coin type ID used as payment coin.
project_coin_left	string	Yes	Remaining project token amount on the curve.
protocol	string	Yes	Bonding curve protocol identifier.
pool_id	string	Yes	Pool identifier on the protocol.
init_virtual_liquidity	string	Yes	Initial virtual liquidity configured by the bonding curve.
target_payment_liquidity	string	Yes	Target payment liquidity required to complete the curve.
is_anti_sniper	boolean	Yes	Indicates whether anti-sniper protection is enabled.

Success Response

{
    "code": 200,
    "message": "OK",
    "data": {
        "coin": {
            "coin_type": "0xb45fcfcc2cc07ce0702cc2d229621e046c906ef14d9b25e8e4d25f6e8763fef7::send::SEND",
            "symbol": "SEND",
            "name": "SEND",
            "logo": "https://suilend-assets.s3.us-east-2.amazonaws.com/SEND/SEND.svg",
            "description": "Suilend is a lending protocol on Sui, built by the team behind Solend.",
            "liquidity": "600520",
            "market_cap": "21581415.13",
            "fdv": "43029021.78",
            "circulating_supply": "50155486.32",
            "total_supply": "100000000",
            "holders": 11898,
            "creator": "0xe3cecd5d663b88553458d2167dd2ef069b219d60218acd4e0916278c147b1205",
            "published_at": "2024-11-29T05:21:05Z",
            "verified": true
        },
        "price_change": {
            "price": "0.43",
            "price_change_1h": -0.92,
            "price_change_6h": 1.85,
            "price_change_1d": 10.06,
            "price_change_7d": -12.33,
            "price_24h_low": "0.227",
            "price_24h_high": "0.45",
            "ath": "616.762",
            "atl": "0.0295"
        },
        "social_media": {
            "x": "https://x.com/suilendprotocol",
            "website": "https://suilend.fi/",
            "discord": "https://discord.com/invite/suilend",
            "coingecko_url": "https://www.coingecko.com/en/coins/suilend",
            "coinmarketcap_url": "https://coinmarketcap.com/currencies/suilend/",
            "docs": "https://docs.suilend.fi/"
        },
        "tags": [
            {
                "id": 0,
                "name": "Lending"
            }
        ],
        "rank": 26,
        "security": {
            "mintable": true,
            "blacklist": true,
            "top_10_holders": 50.49750000000001
        },
        "bonding_curve_info": {
            "protocol_url": "https://blast.fun/token/0x7f372fcdd9ff8de79119e1a417bf4694cce7de4f2539e6dbc255aa684c68da36",
            "bonding_curve_progress": 6.71,
            "payment_coin_collected": "167.69",
            "payment_coin_left": "2332",
            "payment_coin_id": "0x2::sui::SUI",
            "project_coin_left": "474475691",
            "protocol": "blast-fun-bonding-curve",
            "pool_id": "0x7f372fcdd9ff8de79119e1a417bf4694cce7de4f2539e6dbc255aa684c68da36",
            "init_virtual_liquidity": "500",
            "target_payment_liquidity": "2500",
            "is_anti_sniper": true
        }
    }
}

---

See also: Environment Setup