---
title: "Coin Data by ID"
method: GET
path: "/coins/{id}"
---

# Coin Data by ID

`GET /coins/{id}`

To query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin based on a particular coin ID

## Path parameters

- `id` string, required

## Query parameters

- `localization` boolean
- `tickers` boolean
- `market_data` boolean
- `community_data` boolean
- `developer_data` boolean
- `sparkline` boolean
- `include_categories_details` boolean
- `dex_pair_format` 'contract_address' | 'symbol'

## Response `200`

Coin data

- CoinsID
  - `id` string, required — Coin ID
  - `symbol` string, required — Coin symbol
  - `name` string, required — Coin name
  - `web_slug` string, required — Coin web slug
  - `asset_platform_id` string, nullable, required — Coin asset platform ID
  - `platforms` object, required — Coin asset platform and contract address
  - `detail_platforms` object, required — Detailed coin asset platform and contract address
  - `block_time_in_minutes` number, required — Blockchain block time in minutes
  - `hashing_algorithm` string, nullable, required — Blockchain hashing algorithm
  - `categories` string[], required — Coin categories
  - `categories_details` object[] — Detailed coin categories
    - `id` string — Category ID
    - `name` string — Category name
  - `preview_listing` boolean, required — Preview listing coin
  - `public_notice` string, nullable, required — Public notice
  - `additional_notices` string[], required — Additional notices
  - `localization` object — Coin name localization
  - `description` object, required — Coin description
  - `links` object, required — Links
    - `homepage` string[] — Website URL
    - `whitepaper` string — Whitepaper URL
    - `blockchain_site` string[] — Block explorer URL
    - `official_forum_url` string[] — Official forum URL
    - `chat_url` string[] — Chat URL
    - `announcement_url` string[] — Announcement URL
    - `snapshot_url` string, nullable — Snapshot URL
    - `twitter_screen_name` string — Twitter handle
    - `facebook_username` string — Facebook username
    - `bitcointalk_thread_identifier` integer, nullable — Bitcointalk thread identifier
    - `telegram_channel_identifier` string — Telegram channel identifier
    - `subreddit_url` string — Subreddit URL
    - `repos_url` object — Repository URL
      - `github` string[] — GitHub repository URL
      - `bitbucket` string[] — Bitbucket repository URL
  - `image` object, required — Coin image URL
    - `thumb` string
    - `small` string
    - `large` string
  - `country_origin` string, required — Country of origin
  - `genesis_date` string, nullable, required — Genesis date
  - `sentiment_votes_up_percentage` number, nullable, required — Sentiment votes up percentage
  - `sentiment_votes_down_percentage` number, nullable, required — Sentiment votes down percentage
  - `ico_data` object, nullable — ICO data
    - `ico_start_date` string — ICO start date
    - `ico_end_date` string — ICO end date
    - `short_desc` string — Short description
    - `description` string — Detailed description
    - `links` object — ICO related links
    - `softcap_currency` string — Softcap currency
    - `hardcap_currency` string — Hardcap currency
    - `total_raised_currency` string — Total raised currency
    - `softcap_amount` number — Softcap amount
    - `hardcap_amount` number — Hardcap amount
    - `total_raised` number — Total raised amount
    - `quote_pre_sale_currency` string — Quote pre-sale currency
    - `base_pre_sale_amount` number — Base pre-sale amount
    - `quote_pre_sale_amount` number — Quote pre-sale amount
    - `quote_public_sale_currency` string — Quote public sale currency
    - `base_public_sale_amount` number — Base public sale amount
    - `quote_public_sale_amount` number — Quote public sale amount
    - `accepting_currencies` string — Accepting currencies
    - `country_origin` string — Country of origin
    - `pre_sale_start_date` string — Pre-sale start date
    - `pre_sale_end_date` string — Pre-sale end date
    - `whitelist_url` string — Whitelist URL
    - `whitelist_start_date` string — Whitelist start date
    - `whitelist_end_date` string — Whitelist end date
    - `bounty_detail_url` string — Bounty detail URL
    - `amount_for_sale` number — Amount for sale
    - `kyc_required` boolean — KYC required
    - `whitelist_available` boolean — Whitelist available
    - `pre_sale_available` boolean — Pre-sale available
    - `pre_sale_ended` boolean — Pre-sale ended
  - `watchlist_portfolio_users` number, required — Number of users watching this coin in portfolio
  - `market_cap_rank` integer, nullable, required — Market cap rank
  - `market_cap_rank_with_rehypothecated` integer, nullable, required — Market cap rank including rehypothecated tokens
  - `market_data` object — Market data
    - `current_price` object — Current price in target currency
    - `total_value_locked` number, nullable — Total value locked
    - `mcap_to_tvl_ratio` number, nullable — Market cap to TVL ratio
    - `fdv_to_tvl_ratio` number, nullable — FDV to TVL ratio
    - `roi` object, nullable — Return on investment
      - `times` number — ROI multiplier
      - `currency` string — ROI currency
      - `percentage` number — ROI percentage
    - `ath` object — All-time high in target currency
    - `ath_change_percentage` object — All-time high change percentage
    - `ath_date` object — All-time high date
    - `atl` object — All-time low in target currency
    - `atl_change_percentage` object — All-time low change percentage
    - `atl_date` object — All-time low date
    - `market_cap` object — Market cap in target currency
    - `fully_diluted_valuation` object — Fully diluted valuation in target currency
    - `market_cap_fdv_ratio` number — Market cap to FDV ratio
    - `market_cap_rank` integer, nullable — Market cap rank
    - `outstanding_token_value_usd` number, nullable — Outstanding token value in USD
    - `market_cap_rank_with_rehypothecated` integer, nullable — Market cap rank including rehypothecated tokens
    - `total_volume` object — Total trading volume in target currency
    - `high_24h` object — 24h price high in target currency
    - `low_24h` object — 24h price low in target currency
    - `price_change_24h` number — 24h price change in target currency
    - `price_change_percentage_24h` number — 24h price change percentage
    - `price_change_percentage_7d` number — 7d price change percentage
    - `price_change_percentage_14d` number — 14d price change percentage
    - `price_change_percentage_30d` number — 30d price change percentage
    - `price_change_percentage_60d` number — 60d price change percentage
    - `price_change_percentage_200d` number — 200d price change percentage
    - `price_change_percentage_1y` number — 1y price change percentage
    - `market_cap_change_24h` number — 24h market cap change in target currency
    - `market_cap_change_percentage_24h` number — 24h market cap change percentage
    - `price_change_24h_in_currency` object — 24h price change in target currency
    - `price_change_percentage_1h_in_currency` object — 1h price change percentage per currency
    - `price_change_percentage_24h_in_currency` object — 24h price change percentage per currency
    - `price_change_percentage_7d_in_currency` object — 7d price change percentage per currency
    - `price_change_percentage_14d_in_currency` object — 14d price change percentage per currency
    - `price_change_percentage_30d_in_currency` object — 30d price change percentage per currency
    - `price_change_percentage_60d_in_currency` object — 60d price change percentage per currency
    - `price_change_percentage_200d_in_currency` object — 200d price change percentage per currency
    - `price_change_percentage_1y_in_currency` object — 1y price change percentage per currency
    - `market_cap_change_24h_in_currency` object — 24h market cap change in target currency
    - `market_cap_change_percentage_24h_in_currency` object — 24h market cap change percentage per currency
    - `total_supply` number — Total supply
    - `max_supply` number, nullable — Max supply
    - `max_supply_infinite` boolean — Max supply infinite
    - `circulating_supply` number — Circulating supply
    - `outstanding_supply` number, nullable — Tokens outstanding in the market
    - `last_updated` string — Market data last updated timestamp
    - `sparkline_7d` number[] — Sparkline 7-day price data
  - `community_data` object — Community data
    - `facebook_likes` number, nullable — Facebook likes
    - `reddit_average_posts_48h` number — Reddit average posts in 48 hours
    - `reddit_average_comments_48h` number — Reddit average comments in 48 hours
    - `reddit_subscribers` number — Reddit subscribers
    - `reddit_accounts_active_48h` number — Reddit active accounts in 48 hours
    - `telegram_channel_user_count` number, nullable — Telegram channel user count
  - `developer_data` object — Developer data
    - `forks` number — Repository forks
    - `stars` number — Repository stars
    - `subscribers` number — Repository subscribers
    - `total_issues` number — Repository total issues
    - `closed_issues` number — Repository closed issues
    - `pull_requests_merged` number — Repository pull requests merged
    - `pull_request_contributors` number — Repository pull request contributors
    - `code_additions_deletions_4_weeks` object — Code additions and deletions in 4 weeks
      - `additions` number
      - `deletions` number
    - `commit_count_4_weeks` number — Repository commit count in 4 weeks
    - `last_4_weeks_commit_activity_series` number[] — Repository last 4 weeks commit activity series
  - `status_updates` object[], required — Status updates
    - `description` string — Status update description
    - `category` string — Status update category
    - `created_at` string — Status update creation time
    - `user` string — Status update user
    - `user_title` string — Status update user title
  - `last_updated` string, required — Last updated timestamp
  - `tickers` object[] — Tickers
    - `base` string — Ticker base currency
    - `target` string — Ticker target currency
    - `market` object — Ticker exchange
      - `name` string — Exchange name
      - `identifier` string — Exchange identifier
      - `has_trading_incentive` boolean — Exchange trading incentive
    - `last` number — Ticker last price
    - `volume` number — Ticker volume
    - `converted_last` object — Ticker converted last price
      - `btc` number
      - `eth` number
      - `usd` number
    - `converted_volume` object — Ticker converted volume
      - `btc` number
      - `eth` number
      - `usd` number
    - `trust_score` string, nullable — Ticker trust score
    - `bid_ask_spread_percentage` number — Ticker bid-ask spread percentage
    - `timestamp` string — Ticker timestamp
    - `last_traded_at` string — Ticker last traded timestamp
    - `last_fetch_at` string — Ticker last fetch timestamp
    - `is_anomaly` boolean — Ticker anomaly
    - `is_stale` boolean — Ticker stale
    - `trade_url` string — Ticker trade URL
    - `token_info_url` string, nullable — Ticker token info URL
    - `coin_id` string — Ticker base currency coin ID
    - `target_coin_id` string — Ticker target currency coin ID
    - `coin_mcap_usd` number — Market cap in USD

---

[API](https://skmtc.net/coingecko/apis/coingecko-api.md) · [All operations](https://skmtc.net/coingecko/apis/coingecko-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coingecko/coingecko-api/versions/006c13c1a566/schema)
