{ "openapi": "3.0.0", "info": { "title": "CoinGecko Pro API", "version": "3.0.0" }, "servers": [ { "url": "https://pro-api.coingecko.com/api/v3" } ], "security": [ { "headerAuth": [] }, { "queryAuth": [] } ], "paths": { "/ping": { "get": { "summary": "API Server Status", "description": "To check the API server status", "operationId": "ping-server", "x-mint": { "href": "/reference/ping-server" }, "responses": { "200": { "description": "Server status", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PingServer" }, "example": { "gecko_says": "(V3) To the Moon!" } } } } } } }, "/key": { "get": { "summary": "API Usage", "description": "To monitor your account's API usage, including rate limits, monthly total credits, remaining credits, and more", "operationId": "api-usage", "x-mint": { "href": "/reference/api-usage" }, "responses": { "200": { "description": "API usage", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiUsage" }, "example": { "plan": "Other", "rate_limit_request_per_minute": 1000, "monthly_call_credit": 1000000, "current_total_monthly_calls": 32, "current_remaining_monthly_calls": 999968, "api_key_rate_limit_request_per_minute": 1000, "api_key_monthly_call_credit": 1000000, "api_key_current_total_monthly_calls": 8 } } } } } } }, "/simple/price": { "get": { "summary": "Coin Price by IDs, Symbols, or Names", "description": "To query the prices of one or more coins by using their unique Coin API IDs, symbols, or names", "operationId": "simple-price", "x-mint": { "href": "/reference/simple-price" }, "parameters": [ { "name": "vs_currencies", "in": "query", "required": true, "description": "Target currency of coins, comma-separated if querying more than 1 currency. \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies)", "schema": { "type": "string", "default": "usd" } }, { "name": "ids", "in": "query", "required": false, "description": "Coins' IDs, comma-separated if querying more than 1 coin. \n*refers to [`/coins/list`](/reference/coins-list)", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "names", "in": "query", "required": false, "description": "Coins' names, comma-separated if querying more than 1 coin.", "schema": { "type": "string", "default": "Bitcoin" } }, { "name": "symbols", "in": "query", "required": false, "description": "Coins' symbols, comma-separated if querying more than 1 coin.", "schema": { "type": "string", "default": "btc" } }, { "name": "include_tokens", "in": "query", "required": false, "description": "For `symbols` lookups, specify `all` to include all matching tokens. \nDefault `top` returns top-ranked tokens by market cap or volume.", "schema": { "type": "string", "enum": [ "top", "all" ] } }, { "name": "include_market_cap", "in": "query", "required": false, "description": "Include market capitalization. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "include_24hr_vol", "in": "query", "required": false, "description": "Include 24-hour trading volume. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "include_24hr_change", "in": "query", "required": false, "description": "Include 24-hour change percentage. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "include_last_updated_at", "in": "query", "required": false, "description": "Include last updated price time as a UNIX timestamp. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "precision", "in": "query", "required": false, "description": "Decimal places for currency price value", "schema": { "type": "string", "enum": [ "full", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18" ] } } ], "responses": { "200": { "description": "Coin prices", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SimplePrice" }, "example": { "bitcoin": { "usd": 76975, "usd_market_cap": 1542226908349.8406, "usd_24h_vol": 29096603418.89408, "usd_24h_change": -1.4093297098441402, "last_updated_at": 1779092258 } } } } } } } }, "/search": { "get": { "summary": "Search Queries", "description": "To search for coins, categories and markets listed on CoinGecko", "operationId": "search-data", "x-mint": { "href": "/reference/search-data" }, "parameters": [ { "name": "query", "in": "query", "required": true, "description": "Search query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Search" }, "example": { "coins": [ { "id": "ethereum", "name": "Ethereum", "api_symbol": "ethereum", "symbol": "ETH", "market_cap_rank": 2, "thumb": "https://coin-images.coingecko.com/coins/images/279/thumb/ethereum.png", "large": "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png" } ], "exchanges": [ { "id": "uniswap_v3", "name": "Uniswap V3 (Ethereum)", "market_type": "spot", "thumb": "https://coin-images.coingecko.com/markets/images/665/thumb/uniswap-v3.png", "large": "https://coin-images.coingecko.com/markets/images/665/large/uniswap-v3.png" } ], "icos": [], "categories": [ { "id": "ethereum-pos-iou", "name": "Ethereum PoS IOU" } ], "nfts": [ { "id": "ens-ethereum-name-service", "name": "ENS: Ethereum Name Service", "symbol": "ENS", "thumb": "https://coin-images.coingecko.com/nft_contracts/images/373/thumb/ens-ethereum-name-service.png" } ] } } } } } } }, "/simple/supported_vs_currencies": { "get": { "summary": "Currencies List", "description": "To query all the supported currencies on CoinGecko", "operationId": "simple-supported-currencies", "x-mint": { "href": "/reference/simple-supported-currencies" }, "responses": { "200": { "description": "List of supported currencies", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportedCurrencies" }, "example": [ "btc", "eth", "ltc", "bch", "bnb", "eos", "xrp", "xlm", "link", "dot", "yfi", "sol", "usd", "aed", "ars", "aud", "bdt", "bhd", "bmd", "brl", "cad", "chf", "clp", "cny", "czk", "dkk", "eur", "gbp", "gel", "hkd", "huf", "idr", "ils", "inr", "jpy", "krw", "kwd", "lkr", "mmk", "mxn", "myr", "ngn", "nok", "nzd", "php", "pkr", "pln", "rub", "sar", "sek", "sgd", "thb", "try", "twd", "uah", "vef", "vnd", "zar", "xdr", "xag", "xau", "bits", "sats" ] } } } } } }, "/simple/token_price/{id}": { "get": { "summary": "Coin Price by Token Addresses", "description": "To query one or more token prices by using their token contract addresses", "operationId": "simple-token-price", "x-mint": { "href": "/reference/simple-token-price" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Asset platform's ID. \n*refers to [`/asset_platforms`](/reference/asset-platforms-list)", "schema": { "type": "string", "default": "ethereum" } }, { "name": "contract_addresses", "in": "query", "required": true, "description": "Token contract addresses, comma-separated if querying more than 1 token", "schema": { "type": "string", "default": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599" } }, { "name": "vs_currencies", "in": "query", "required": true, "description": "Target currency of coins, comma-separated if querying more than 1 currency. \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies)", "schema": { "type": "string", "default": "usd" } }, { "name": "include_market_cap", "in": "query", "required": false, "description": "Include market capitalization. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "include_24hr_vol", "in": "query", "required": false, "description": "Include 24-hour trading volume. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "include_24hr_change", "in": "query", "required": false, "description": "Include 24-hour change percentage. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "include_last_updated_at", "in": "query", "required": false, "description": "Include last updated price time as a UNIX timestamp. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "precision", "in": "query", "required": false, "description": "Decimal places for currency price value", "schema": { "type": "string", "enum": [ "full", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18" ] } } ], "responses": { "200": { "description": "Token prices", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SimplePrice" }, "example": { "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599": { "usd": 76721, "usd_market_cap": 9008047197.715635, "usd_24h_vol": 181232010.10689816, "usd_24h_change": -1.6069562341774564, "last_updated_at": 1779094527 } } } } } } } }, "/coins/top_gainers_losers": { "get": { "summary": "Top Gainers & Losers", "description": "To query the top 30 coins with largest price gain and loss by a specific time duration", "operationId": "coins-top-gainers-losers", "x-mint": { "href": "/reference/coins-top-gainers-losers" }, "parameters": [ { "name": "vs_currency", "in": "query", "required": true, "description": "Target currency of coins. \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies)", "schema": { "type": "string", "default": "usd" } }, { "name": "duration", "in": "query", "required": false, "description": "Filter result by time range. \nDefault: `24h`", "schema": { "type": "string", "enum": [ "1h", "24h", "7d", "14d", "30d", "60d", "1y" ] } }, { "name": "price_change_percentage", "in": "query", "required": false, "description": "Include price change percentage timeframe, comma-separated if querying more than 1 timeframe. \nValid values: `1h`, `24h`, `7d`, `14d`, `30d`, `60d`, `200d`, `1y`", "schema": { "type": "string" } }, { "name": "top_coins", "in": "query", "required": false, "description": "Filter result by market cap ranking (top 300 to 1000) or all coins (including coins that do not have market cap). \nDefault: `1000`", "schema": { "type": "string", "enum": [ "300", "500", "1000", "all" ] } } ], "responses": { "200": { "description": "Top gainers and losers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TopGainersLosers" }, "example": { "top_gainers": [ { "id": "maga-bitcoin", "symbol": "mbtc", "name": "MAGA Bitcoin", "image": "https://coin-images.coingecko.com/coins/images/102172497/original/image0-removebg-preview.webp?1773518858", "market_cap_rank": 189, "usd": 0.17408997149936514, "usd_24h_vol": 50396.8060000212, "usd_24h_change": 150.5022699272054, "usd_1h_change": -6.503819291482131, "usd_7d_change": 519.1190967122302, "usd_14d_change": 461.9068555244123, "usd_30d_change": 448.72555160441027, "usd_60d_change": 67.38949093422981, "usd_200d_change": null, "usd_1y_change": null } ], "top_losers": [ { "id": "irys", "symbol": "irys", "name": "Irys", "image": "https://coin-images.coingecko.com/coins/images/70808/original/irys.png?1764757341", "market_cap_rank": 352, "usd": 0.038636564524228145, "usd_24h_vol": 77344929.5624576, "usd_24h_change": -19.511341677152053, "usd_1h_change": 1.6279519726091103, "usd_7d_change": 0.8723104841951528, "usd_14d_change": -3.0080471375482483, "usd_30d_change": 35.11913273728426, "usd_60d_change": 119.67467634522242, "usd_200d_change": null, "usd_1y_change": null } ] } } } } } } }, "/coins/{id}": { "get": { "summary": "Coin Data by ID", "description": "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", "operationId": "coins-id", "x-mint": { "href": "/reference/coins-id" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list)", "schema": { "type": "string", "example": "bitcoin", "default": "bitcoin" } }, { "name": "localization", "in": "query", "required": false, "description": "Include all localized languages in the response. \nDefault: true", "schema": { "type": "boolean" } }, { "name": "tickers", "in": "query", "required": false, "description": "Include tickers data. \nDefault: true", "schema": { "type": "boolean" } }, { "name": "market_data", "in": "query", "required": false, "description": "Include market data. \nDefault: true", "schema": { "type": "boolean" } }, { "name": "community_data", "in": "query", "required": false, "description": "Include community data. \nDefault: true", "schema": { "type": "boolean" } }, { "name": "developer_data", "in": "query", "required": false, "description": "Include developer data. \nDefault: true", "schema": { "type": "boolean" } }, { "name": "sparkline", "in": "query", "required": false, "description": "Include sparkline 7-day data. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "include_categories_details", "in": "query", "required": false, "description": "Include categories details. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "dex_pair_format", "in": "query", "required": false, "description": "Set to `symbol` to display DEX pair base and target as symbols. \nDefault: `contract_address`", "schema": { "type": "string", "enum": [ "contract_address", "symbol" ] } } ], "responses": { "200": { "description": "Coin data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsID" }, "example": { "id": "bitcoin", "symbol": "btc", "name": "Bitcoin", "web_slug": "bitcoin", "asset_platform_id": null, "platforms": { "": "" }, "detail_platforms": { "": { "decimal_place": null, "contract_address": "" } }, "block_time_in_minutes": 10, "hashing_algorithm": "SHA-256", "categories": [ "Cryptocurrency", "Layer 1 (L1)" ], "preview_listing": false, "public_notice": null, "additional_notices": [], "description": { "en": "Bitcoin is the first successful internet money based on peer-to-peer technology..." }, "links": { "homepage": [ "http://www.bitcoin.org", "", "" ], "whitepaper": "https://bitcoin.org/bitcoin.pdf", "blockchain_site": [ "https://mempool.space/", "https://blockchair.com/bitcoin/" ], "official_forum_url": [ "https://bitcointalk.org/" ], "chat_url": [ "" ], "announcement_url": [ "", "" ], "snapshot_url": null, "twitter_screen_name": "bitcoin", "facebook_username": "bitcoins", "bitcointalk_thread_identifier": null, "telegram_channel_identifier": "", "subreddit_url": "https://www.reddit.com/r/Bitcoin/", "repos_url": { "github": [ "https://github.com/bitcoin/bitcoin", "https://github.com/bitcoin/bips" ], "bitbucket": [] } }, "image": { "thumb": "https://assets.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400", "small": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400", "large": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png?1696501400" }, "country_origin": "", "genesis_date": "2009-01-03", "sentiment_votes_up_percentage": 84.07, "sentiment_votes_down_percentage": 15.93, "watchlist_portfolio_users": 1541900, "market_cap_rank": 1, "market_cap_rank_with_rehypothecated": 1, "status_updates": [], "last_updated": "2024-04-07T15:24:51.021Z", "market_data": { "current_price": { "btc": 1, "eur": 64375, "usd": 69840 }, "total_value_locked": null, "mcap_to_tvl_ratio": null, "fdv_to_tvl_ratio": null, "roi": null, "ath": { "btc": 1.003301, "eur": 67405, "usd": 73738 }, "ath_change_percentage": { "btc": -0.32896, "eur": -4.54383, "usd": -5.33399 }, "ath_date": { "btc": "2024-03-02T16:05:19.446Z", "eur": "2024-03-14T07:10:36.635Z", "usd": "2024-03-14T07:10:36.635Z" }, "atl": { "btc": 0.99895134, "eur": 51.3, "usd": 67.81 }, "atl_change_percentage": { "btc": 0.10408, "eur": 125385.41242, "usd": 102882.36498 }, "atl_date": { "btc": "2019-10-21T00:00:00.000Z", "eur": "2013-07-05T00:00:00.000Z", "usd": "2013-07-06T00:00:00.000Z" }, "market_cap": { "btc": 19675377, "eur": 1265825267281, "usd": 1373296629498 }, "fully_diluted_valuation": { "btc": 21000000, "eur": 1351831155, "usd": 1466577759 }, "market_cap_fdv_ratio": 1, "market_cap_rank": 1, "outstanding_token_value_usd": null, "market_cap_rank_with_rehypothecated": 1, "total_volume": { "btc": 270165, "eur": 17368113665, "usd": 18867210007 }, "high_24h": { "btc": 1, "eur": 64343, "usd": 69805 }, "low_24h": { "btc": 1, "eur": 62695, "usd": 67985 }, "price_change_24h": 1619, "price_change_percentage_24h": 2.37311, "price_change_percentage_7d": -0.89706, "price_change_percentage_14d": 6.36178, "price_change_percentage_30d": 1.81171, "price_change_percentage_60d": 62.54292, "price_change_percentage_200d": 157.51875, "price_change_percentage_1y": 149.76989, "market_cap_change_24h": 31172487848, "market_cap_change_percentage_24h": 2.32219, "price_change_24h_in_currency": { "btc": 0, "eur": 1461.64, "usd": 1618.95 }, "price_change_percentage_1h_in_currency": { "btc": 0, "eur": 0.79523, "usd": 0.79523 }, "price_change_percentage_24h_in_currency": { "btc": 0, "eur": 2.32219, "usd": 2.37311 }, "price_change_percentage_7d_in_currency": { "btc": 0, "eur": -1.01955, "usd": -0.89706 }, "price_change_percentage_14d_in_currency": { "btc": 0, "eur": 5.84662, "usd": 6.36178 }, "price_change_percentage_30d_in_currency": { "btc": 0, "eur": 2.28048, "usd": 1.81171 }, "price_change_percentage_60d_in_currency": { "btc": 0, "eur": 60.98834, "usd": 62.54292 }, "price_change_percentage_200d_in_currency": { "btc": 0, "eur": 148.68948, "usd": 157.51875 }, "price_change_percentage_1y_in_currency": { "btc": 0, "eur": 138.20277, "usd": 149.76989 }, "market_cap_change_24h_in_currency": { "btc": -49432, "eur": 28668703539, "usd": 31172487848 }, "market_cap_change_percentage_24h_in_currency": { "btc": -0.25084, "eur": 2.31801, "usd": 2.32219 }, "total_supply": 21000000, "max_supply": 21000000, "max_supply_infinite": false, "circulating_supply": 19675377, "outstanding_supply": null, "last_updated": "2024-04-07T15:24:51.021Z" }, "community_data": { "facebook_likes": null, "reddit_average_posts_48h": 7.333, "reddit_average_comments_48h": 384.667, "reddit_subscribers": 6127543, "reddit_accounts_active_48h": 3498, "telegram_channel_user_count": null }, "developer_data": { "forks": 36433, "stars": 76697, "subscribers": 3967, "total_issues": 7743, "closed_issues": 7379, "pull_requests_merged": 11204, "pull_request_contributors": 829, "code_additions_deletions_4_weeks": { "additions": 1264, "deletions": -1314 }, "commit_count_4_weeks": 108, "last_4_weeks_commit_activity_series": [ 0, 3, 2, 0, 1, 0, 0 ] }, "tickers": [ { "base": "BTC", "target": "USDT", "market": { "name": "Binance", "identifier": "binance", "has_trading_incentive": false }, "last": 69816, "volume": 19988.82111, "converted_last": { "btc": 0.99999255, "eth": 20.441016, "usd": 69835 }, "converted_volume": { "btc": 19783, "eth": 404380, "usd": 1381537193 }, "trust_score": null, "bid_ask_spread_percentage": 0.010014, "timestamp": "2024-04-07T15:23:02+00:00", "last_traded_at": "2024-04-07T15:23:02+00:00", "last_fetch_at": "2024-04-07T15:24:00+00:00", "is_anomaly": false, "is_stale": false, "trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157", "token_info_url": null, "coin_id": "bitcoin", "target_coin_id": "tether", "coin_mcap_usd": 230926944910.5146 } ] } } } } } } }, "/coins/markets": { "get": { "summary": "Coins List with Market Data", "description": "To query all the supported coins with price, market cap, volume and market related data", "operationId": "coins-markets", "x-mint": { "href": "/reference/coins-markets" }, "parameters": [ { "name": "vs_currency", "in": "query", "required": true, "description": "Target currency of coins and market data. \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies)", "schema": { "type": "string", "default": "usd" } }, { "name": "ids", "in": "query", "required": false, "description": "Coins' IDs, comma-separated if querying more than 1 coin. \n*refers to [`/coins/list`](/reference/coins-list)", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "names", "in": "query", "required": false, "description": "Coins' names, comma-separated if querying more than 1 coin.", "schema": { "type": "string", "default": "Bitcoin" } }, { "name": "symbols", "in": "query", "required": false, "description": "Coins' symbols, comma-separated if querying more than 1 coin.", "schema": { "type": "string", "default": "btc" } }, { "name": "include_tokens", "in": "query", "required": false, "description": "For `symbols` lookups, specify `all` to include all matching tokens. \nDefault `top` returns top-ranked tokens by market cap or volume.", "schema": { "type": "string", "enum": [ "top", "all" ] } }, { "name": "category", "in": "query", "required": false, "description": "Filter based on coins' category. \n*refers to [`/coins/categories/list`](/reference/coins-categories-list)", "schema": { "type": "string" } }, { "name": "order", "in": "query", "required": false, "description": "Sort result by field. \nDefault: market_cap_desc", "schema": { "type": "string", "enum": [ "market_cap_asc", "market_cap_desc", "volume_asc", "volume_desc", "id_asc", "id_desc" ] } }, { "name": "per_page", "in": "query", "required": false, "description": "Total results per page. \nDefault: 100 \nValid values: 1...250", "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault: 1", "schema": { "type": "integer" } }, { "name": "sparkline", "in": "query", "required": false, "description": "Include sparkline 7-day data. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "price_change_percentage", "in": "query", "required": false, "description": "Include price change percentage timeframe, comma-separated if querying more than 1 timeframe. \nValid values: `1h`, `24h`, `7d`, `14d`, `30d`, `200d`, `1y`", "schema": { "type": "string" } }, { "name": "locale", "in": "query", "required": false, "description": "Language background. \nDefault: en", "schema": { "type": "string", "enum": [ "ar", "bg", "cs", "da", "de", "el", "en", "es", "fi", "fr", "he", "hi", "hr", "hu", "id", "it", "ja", "ko", "lt", "nl", "no", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "th", "tr", "uk", "vi", "zh", "zh-tw" ] } }, { "name": "precision", "in": "query", "required": false, "description": "Decimal places for currency price value", "schema": { "type": "string", "enum": [ "full", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18" ] } }, { "name": "include_rehypothecated", "in": "query", "required": false, "description": "Include rehypothecated tokens in results. When true, returns `market_cap_rank_with_rehypothecated` field. \nDefault: false", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "List of coins with market data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsMarkets" }, "example": [ { "id": "bitcoin", "symbol": "btc", "name": "Bitcoin", "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400", "current_price": 77671, "market_cap": 1555886872303, "market_cap_rank": 1, "fully_diluted_valuation": 1555914058873, "total_volume": 33235034316, "high_24h": 78419, "low_24h": 76696, "price_change_24h": -747.3360347281705, "price_change_percentage_24h": -0.95302, "market_cap_change_24h": -15184401491.513184, "market_cap_change_percentage_24h": -0.9665, "circulating_supply": 20030493.0, "total_supply": 20030843.0, "max_supply": 21000000.0, "ath": 126080, "ath_change_percentage": -38.39571, "ath_date": "2025-10-06T18:57:42.558Z", "atl": 67.81, "atl_change_percentage": 114443.23093, "atl_date": "2013-07-06T00:00:00.000Z", "roi": null, "last_updated": "2026-05-18T12:49:21.599Z", "market_cap_rank_with_rehypothecated": 1, "sparkline_in_7d": { "price": [ 81045.84776489827, 81001.73089268175, 80898.20817826076 ] }, "price_change_percentage_1h_in_currency": 0.5823392426906319, "price_change_percentage_24h_in_currency": -0.9530164743774191, "price_change_percentage_7d_in_currency": -4.042267423689584, "price_change_percentage_14d_in_currency": -1.5720857443461431, "price_change_percentage_30d_in_currency": 1.9453890367549207, "price_change_percentage_200d_in_currency": -29.452371850925864, "price_change_percentage_1y_in_currency": -25.214612207475373 } ] } } } } } }, "/coins/{id}/tickers": { "get": { "summary": "Coin Tickers by ID", "description": "To query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID", "operationId": "coins-id-tickers", "x-mint": { "href": "/reference/coins-id-tickers" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list)", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "exchange_ids", "in": "query", "required": false, "description": "Exchange ID. \n*refers to [`/exchanges/list`](/reference/exchanges-list)", "schema": { "type": "string" } }, { "name": "include_exchange_logo", "in": "query", "required": false, "description": "Include exchange logo. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results", "schema": { "type": "integer" } }, { "name": "order", "in": "query", "required": false, "description": "Sort the order of responses. \nDefault: trust_score_desc", "schema": { "type": "string", "enum": [ "trust_score_desc", "trust_score_asc", "volume_desc", "volume_asc" ] } }, { "name": "depth", "in": "query", "required": false, "description": "Include 2% orderbook depth, i.e. `cost_to_move_up_usd` and `cost_to_move_down_usd`. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "dex_pair_format", "in": "query", "required": false, "description": "Set to `symbol` to display DEX pair base and target as symbols. \nDefault: `contract_address`", "schema": { "type": "string", "enum": [ "contract_address", "symbol" ] } } ], "responses": { "200": { "description": "Coin tickers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsIdTickers" }, "example": { "name": "Bitcoin", "tickers": [ { "base": "BTC", "target": "USDT", "market": { "name": "Binance", "identifier": "binance", "has_trading_incentive": false, "logo": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274" }, "last": 76894.07, "volume": 13786.06991, "cost_to_move_up_usd": 19320706.3958517, "cost_to_move_down_usd": 16360235.3694131, "converted_last": { "btc": 0.99664066, "eth": 36.004874, "usd": 76856 }, "converted_volume": { "btc": 13740, "eth": 496366, "usd": 1059536991 }, "trust_score": null, "bid_ask_spread_percentage": 0.010013, "timestamp": "2026-05-18T13:37:29+00:00", "last_traded_at": "2026-05-18T13:37:29+00:00", "last_fetch_at": "2026-05-18T13:37:29+00:00", "is_anomaly": false, "is_stale": false, "trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157", "token_info_url": null, "coin_id": "bitcoin", "target_coin_id": "tether", "coin_mcap_usd": 1544810408447.1313 } ] } } } } } } }, "/coins/{id}/history": { "get": { "summary": "Coin Historical Data by ID", "description": "To query the historical data (price, market cap, 24hrs volume, etc.) at a given date for a coin based on a particular coin ID", "operationId": "coins-id-history", "x-mint": { "href": "/reference/coins-id-history" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "date", "in": "query", "required": true, "description": "The date of data snapshot. \nFormat: `YYYY-MM-DD`", "schema": { "type": "string", "default": "2025-12-30" } }, { "name": "localization", "in": "query", "required": false, "description": "Include all the localized languages in response. \nDefault: true", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Coin historical data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsIdHistory" }, "example": { "id": "bitcoin", "symbol": "btc", "name": "Bitcoin", "localization": { "en": "Bitcoin", "zh": "比特币", "zh-tw": "比特幣", "de": "Bitcoin", "fr": "Bitcoin", "es": "Bitcoin", "ja": "ビットコイン", "id": "Bitcoin", "ru": "Биткоин", "ko": "비트코인", "ar": "بيتكوين", "th": "บิตคอยน์", "vi": "Bitcoin", "it": "Bitcoin", "pl": "Bitcoin", "tr": "Bitcoin", "hu": "Bitcoin", "nl": "Bitcoin", "ro": "Bitcoin", "sv": "Bitcoin", "cs": "Bitcoin", "da": "Bitcoin", "el": "Bitcoin", "hi": "Bitcoin", "no": "Bitcoin", "sk": "Bitcoin", "uk": "Bitcoin", "he": "Bitcoin", "fi": "Bitcoin", "bg": "Bitcoin", "hr": "Bitcoin", "lt": "Bitcoin", "sl": "Bitcoin", "pt": "Bitcoin" }, "image": { "thumb": "https://coin-images.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400", "small": "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png?1696501400" }, "market_data": { "current_price": { "aed": 155021.01870663263, "ars": 34223222.03038811, "aud": 61961.64079464181, "bch": 162.9444394169128, "bdt": 4640974.295329716, "bhd": 15935.706731619232, "bmd": 42208.202176186474, "bnb": 135.24654224991627, "brl": 204813.86598107114, "btc": 1.0, "cad": 55925.65684243621, "chf": 35496.88698916195, "clp": 37196103.56833302, "cny": 298785.10989287664, "czk": 944615.3438828368, "dkk": 285068.92147269147, "dot": 5160.299955562896, "eos": 50098.037591566885, "eth": 18.514283305187227, "eur": 38240.20908960317, "gbp": 33156.484386694596, "gel": 113329.02284306048, "hkd": 329606.38328597124, "huf": 14657368.01641012, "idr": 649885162.0865278, "ils": 152105.57155771676, "inr": 3513053.119048727, "jpy": 5952559.440604322, "krw": 54661344.54593342, "kwd": 12984.298194449415, "lkr": 13696906.151726862, "ltc": 579.0962960970021, "mmk": 88806742.41781776, "mxn": 716452.3647481233, "myr": 194052.20950501712, "ngn": 37886364.22413555, "nok": 429442.7101393702, "nzd": 66802.583918633, "php": 2338503.1911612307, "pkr": 11792242.372501094, "pln": 165880.09171330827, "rub": 3767047.138041446, "sar": 158357.45046405343, "sek": 425811.11642413173, "sgd": 55694.77797653248, "sol": 416.5289478886034, "thb": 1453127.860988517, "try": 1243001.417432343, "twd": 1295461.9075007213, "uah": 1607901.3285893872, "usd": 42208.202176186474, "vef": 4226.30728390156, "vnd": 1024346748.4635574, "xag": 1773.9385614394023, "xau": 20.435523165622502, "xdr": 31508.676173736272, "xlm": 327801.5907899002, "xrp": 68792.39040895543, "yfi": 5.23330767599715, "zar": 772207.5004537676, "bits": 999797.6500840397, "link": 2828.6459350540995, "sats": 99979765.00840396 }, "market_cap": { "aed": 3039570628249.035, "ars": 671030943774608.1, "aud": 1214911274669.9553, "bch": 3192400331.4673758, "bdt": 90997783863352.8, "bhd": 312458958958.8847, "bmd": 827596236151.1959, "bnb": 2647323702.8955383, "brl": 4015882597651.6562, "btc": 19586150.0, "cad": 1096560874919.1543, "chf": 696004296621.9747, "clp": 729321641896660.1, "cny": 5858421340316.535, "czk": 18521521005440.16, "dkk": 5589481529435.656, "dot": 101067225072.82333, "eos": 981764701266.0074, "eth": 362734483.2978319, "eur": 749793913990.623, "gbp": 650114912923.6271, "gel": 2222095894065.9663, "hkd": 6462748663878.865, "huf": 287393965552690.7, "idr": 12742606563251504, "ils": 2982406073429.352, "inr": 68882098474316.74, "jpy": 116714655790049.02, "krw": 1071770904156178.4, "kwd": 254589292146.01266, "lkr": 268561734299139.16, "ltc": 11369266145.87004, "mmk": 1741275912749029.8, "mxn": 14047821273508.254, "myr": 3804873695705.123, "ngn": 742855909912170.9, "nok": 8420286869134.373, "nzd": 1309829942186.6091, "php": 45852141040124.65, "pkr": 231216088345279.94, "pln": 3252489622308.595, "rub": 73862279654407.0, "sar": 3104989627928.0786, "sek": 8349080488975.917, "sgd": 1092033923507.4076, "sol": 8167080608.685882, "thb": 28493545024184.4, "try": 24372118250940.145, "twd": 25400735957660.043, "uah": 31526883852775.1, "usd": 827596236151.1959, "vef": 82867211125.81927, "vnd": 20084852465487144, "xag": 34782454615.8709, "xau": 400688993.6949639, "xdr": 617805555864.2843, "xlm": 6420377180809.443, "xrp": 1347730925908.2449, "yfi": 102656498.40039586, "zar": 15141038659633.365, "bits": 19587615789973.43, "link": 55342736984.57576, "sats": 1958761578997342.8 }, "total_volume": { "aed": 52093574029.40443, "ars": 11500440167656.37, "aud": 20821714040.129295, "bch": 54756176.21574547, "bdt": 1559562309933.2505, "bhd": 5355066850.034618, "bmd": 14183728910.169804, "bnb": 45448519.30208316, "brl": 68826062289.8161, "btc": 335974.0074837291, "cad": 18793369887.330444, "chf": 11928445094.808254, "clp": 12499453241945.738, "cny": 100404347558.46667, "czk": 317430434636.70953, "dkk": 95795132093.1731, "dot": 1734077546.3343449, "eos": 16835045026.655567, "eth": 6221576.893294353, "eur": 12850316555.324738, "gbp": 11141971510.468252, "gel": 38083312123.805855, "hkd": 110761590083.25078, "huf": 4925491344396.748, "idr": 218388713248196.1, "ils": 51113861322.39222, "inr": 1180533415747.48, "jpy": 2000310012607.8845, "krw": 18368507847565.402, "kwd": 4363269605.991003, "lkr": 4602735813129.19, "ltc": 194600680.75008962, "mmk": 29842795828917.508, "mxn": 240758089534.80554, "myr": 65209693664.5056, "ngn": 12731409817077.545, "nok": 144310789586.34262, "nzd": 22448474276.294495, "php": 785835302355.318, "pkr": 3962688776849.6025, "pln": 55742678701.03927, "rub": 1265886075288.8472, "sar": 53214755248.56654, "sek": 143090421550.91183, "sgd": 18715784890.19182, "sol": 139971223.0203305, "thb": 488312000734.88245, "try": 417700689222.06055, "twd": 435329617517.0529, "uah": 540322387194.22906, "usd": 14183728910.169804, "vef": 1420216775.7753053, "vnd": 344223535737756.94, "xag": 596117871.9180025, "xau": 6867194.189147832, "xdr": 10588238733.815224, "xlm": 110155103993.25989, "xrp": 23117132839.969418, "yfi": 1758611.2071300931, "zar": 259494157157.33887, "bits": 335974007483.7291, "link": 950543853.0214615, "sats": 33597400748372.91 } }, "community_data": { "facebook_likes": null, "reddit_average_posts_48h": 0.0, "reddit_average_comments_48h": 0.0, "reddit_subscribers": null, "reddit_accounts_active_48h": 0.0 }, "developer_data": { "forks": null, "stars": null, "subscribers": null, "total_issues": null, "closed_issues": null, "pull_requests_merged": null, "pull_request_contributors": null, "code_additions_deletions_4_weeks": { "additions": null, "deletions": null }, "commit_count_4_weeks": null }, "public_interest_stats": { "alexa_rank": null, "bing_matches": null } } } } } } } }, "/coins/{id}/market_chart": { "get": { "summary": "Coin Historical Chart Data by ID", "description": "To get the historical chart data of a coin including time in UNIX, price, market cap and 24hrs volume based on particular coin ID", "operationId": "coins-id-market-chart", "x-mint": { "href": "/reference/coins-id-market-chart" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "vs_currency", "in": "query", "required": true, "description": "Target currency of market data. \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).", "schema": { "type": "string", "default": "usd" } }, { "name": "days", "in": "query", "required": true, "description": "Data up to number of days ago. \nYou may use any integer or `max` for number of days.", "schema": { "type": "string", "default": "1" } }, { "name": "interval", "in": "query", "required": false, "description": "Data interval, leave empty for auto granularity.", "schema": { "type": "string", "enum": [ "5m", "hourly", "daily" ] } }, { "name": "precision", "in": "query", "required": false, "description": "Decimal place for currency price value.", "schema": { "type": "string", "enum": [ "full", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18" ] } } ], "responses": { "200": { "description": "Coin historical chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsMarketChart" }, "example": { "prices": [ [ 1779027899041, 77953.82550382407 ], [ 1779028199661, 78052.87543398788 ] ], "market_caps": [ [ 1779027899041, 1560631481361.8042 ], [ 1779028199661, 1562027330524.267 ] ], "total_volumes": [ [ 1779027899041, 18688431751.857048 ], [ 1779028199661, 18974828816.446976 ] ] } } } } } } }, "/coins/{id}/market_chart/range": { "get": { "summary": "Coin Historical Chart Data within Time Range by ID", "description": "To get the historical chart data of a coin within certain time range in UNIX along with price, market cap and 24hrs volume based on particular coin ID", "operationId": "coins-id-market-chart-range", "x-mint": { "href": "/reference/coins-id-market-chart-range" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "vs_currency", "in": "query", "required": true, "description": "Target currency of market data. \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).", "schema": { "type": "string", "default": "usd" } }, { "name": "from", "in": "query", "required": true, "description": "Starting date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. \n**Use ISO date string for best compatibility.**", "schema": { "type": "string", "default": "2025-01-01" } }, { "name": "to", "in": "query", "required": true, "description": "Ending date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. \n**Use ISO date string for best compatibility.**", "schema": { "type": "string", "default": "2025-12-31" } }, { "name": "interval", "in": "query", "required": false, "description": "Data interval, leave empty for auto granularity.", "schema": { "type": "string", "enum": [ "5m", "hourly", "daily" ] } }, { "name": "precision", "in": "query", "required": false, "description": "Decimal place for currency price value.", "schema": { "type": "string", "enum": [ "full", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18" ] } } ], "responses": { "200": { "description": "Coin historical chart data within time range", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsMarketChart" }, "example": { "prices": [ [ 1779027899041, 77953.82550382407 ], [ 1779028199661, 78052.87543398788 ] ], "market_caps": [ [ 1779027899041, 1560631481361.8042 ], [ 1779028199661, 1562027330524.267 ] ], "total_volumes": [ [ 1779027899041, 18688431751.857048 ], [ 1779028199661, 18974828816.446976 ] ] } } } } } } }, "/coins/{id}/ohlc": { "get": { "summary": "Coin OHLC Chart by ID", "description": "To get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID", "operationId": "coins-id-ohlc", "x-mint": { "href": "/reference/coins-id-ohlc" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "vs_currency", "in": "query", "required": true, "description": "Target currency of price data. \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).", "schema": { "type": "string", "default": "usd" } }, { "name": "days", "in": "query", "required": true, "description": "Data up to number of days ago.", "schema": { "type": "string", "default": "1", "enum": [ "1", "7", "14", "30", "90", "180", "365", "max" ] } }, { "name": "interval", "in": "query", "required": false, "description": "Data interval, leave empty for auto granularity.", "schema": { "type": "string", "enum": [ "daily", "hourly" ] } }, { "name": "precision", "in": "query", "required": false, "description": "Decimal place for currency price value.", "schema": { "type": "string", "enum": [ "full", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18" ] } } ], "responses": { "200": { "description": "Coin OHLC chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsOHLC" }, "example": [ [ 1779199200000, 76769.0, 76889.0, 76744.0, 76818.0 ], [ 1779201000000, 76712.0, 76712.0, 76321.0, 76422.0 ] ] } } } } } }, "/coins/{id}/ohlc/range": { "get": { "summary": "Coin OHLC Chart within Time Range by ID", "description": "To get the OHLC chart (Open, High, Low, Close) of a coin within a range of timestamp based on particular coin ID", "operationId": "coins-id-ohlc-range", "x-mint": { "href": "/reference/coins-id-ohlc-range" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "vs_currency", "in": "query", "required": true, "description": "Target currency of price data. \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).", "schema": { "type": "string", "default": "usd" } }, { "name": "from", "in": "query", "required": true, "description": "Starting date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. \n**Use ISO date string for best compatibility.**", "schema": { "type": "string", "default": "2025-12-01" } }, { "name": "to", "in": "query", "required": true, "description": "Ending date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. \n**Use ISO date string for best compatibility.**", "schema": { "type": "string", "default": "2025-12-31" } }, { "name": "interval", "in": "query", "required": true, "description": "Data interval.", "schema": { "type": "string", "default": "daily", "enum": [ "daily", "hourly" ] } } ], "responses": { "200": { "description": "Coin OHLC chart data within time range", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsOHLC" }, "example": [ [ 1764547200000, 90832.0, 91905.0, 90406.0, 90406.0 ], [ 1764633600000, 90360.0, 90360.0, 83989.0, 86281.0 ] ] } } } } } }, "/coins/{id}/contract/{contract_address}": { "get": { "summary": "Coin Data by Token Address", "description": "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 an asset platform and a particular token contract address", "operationId": "coins-contract-address", "x-mint": { "href": "/reference/coins-contract-address" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Asset platform ID. \n*refers to [`/asset_platforms`](/reference/asset-platforms-list).", "schema": { "type": "string", "default": "ethereum" } }, { "name": "contract_address", "in": "path", "required": true, "description": "The contract address of token.", "schema": { "type": "string", "default": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" } } ], "responses": { "200": { "description": "Coin data by token contract address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsContractAddress" }, "example": { "id": "weth", "symbol": "weth", "name": "WETH", "web_slug": "weth", "asset_platform_id": "ethereum", "platforms": { "ethereum": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "terra-2": "ibc/BC8A77AFBD872FDC32A348D3FB10CC09277C266CFE52081DE341C7EC6752E674", "tron": "THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF" }, "detail_platforms": { "ethereum": { "decimal_place": 18, "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "geckoterminal_url": "https://www.geckoterminal.com/eth/tokens/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }, "terra-2": { "decimal_place": 18, "contract_address": "ibc/BC8A77AFBD872FDC32A348D3FB10CC09277C266CFE52081DE341C7EC6752E674" }, "tron": { "decimal_place": 18, "contract_address": "THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF", "geckoterminal_url": "https://www.geckoterminal.com/tron/tokens/THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF" } }, "block_time_in_minutes": 0, "hashing_algorithm": null, "categories": [ "Crypto-Backed Tokens", "Wrapped-Tokens", "Terra Ecosystem", "Ethereum Ecosystem", "FTX Holdings", "Tron Ecosystem", "Index Coop Defi Index" ], "preview_listing": false, "public_notice": null, "additional_notices": [], "localization": { "en": "WETH", "de": "", "es": "", "fr": "", "it": "", "pl": "", "ro": "", "hu": "", "nl": "", "pt": "" }, "description": { "en": "What is WETH (Wrapped ETH)?\nWETH is the tokenized/packaged form of ETH..." }, "links": { "homepage": [ "https://ethereum.org/en/wrapped-eth" ], "whitepaper": "", "blockchain_site": [ "https://etherscan.io/token/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "https://intel.arkm.com/explorer/token/weth" ], "official_forum_url": [], "chat_url": [], "announcement_url": [], "snapshot_url": null, "twitter_screen_name": "", "facebook_username": "", "bitcointalk_thread_identifier": null, "telegram_channel_identifier": "", "subreddit_url": null, "repos_url": { "github": [], "bitbucket": [] } }, "image": { "thumb": "https://coin-images.coingecko.com/coins/images/2518/thumb/weth.png?1696503332", "small": "https://coin-images.coingecko.com/coins/images/2518/small/weth.png?1696503332", "large": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332" }, "country_origin": "", "genesis_date": "2016-06-17", "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "sentiment_votes_up_percentage": null, "sentiment_votes_down_percentage": null, "watchlist_portfolio_users": 34782, "market_cap_rank": null, "market_cap_rank_with_rehypothecated": 30, "market_data": { "current_price": { "btc": 0.02728343, "eth": 0.99972363, "usd": 2115.04 }, "total_value_locked": null, "mcap_to_tvl_ratio": null, "fdv_to_tvl_ratio": null, "roi": null, "ath": { "btc": 0.14280504, "eth": 3.614831, "usd": 4950.08 }, "ath_change_percentage": { "btc": -80.89678, "eth": -72.33124, "usd": -57.2622 }, "ath_date": { "btc": "2018-09-02T00:00:00.000Z", "eth": "2018-09-13T00:00:00.000Z", "usd": "2025-08-24T19:28:11.411Z" }, "atl": { "btc": 0.00890197, "eth": 0.22395179, "usd": 82.1 }, "atl_change_percentage": { "btc": 206.45314, "eth": 346.6045, "usd": 2476.69436 }, "atl_date": { "btc": "2025-09-02T07:56:48.935Z", "eth": "2025-09-02T07:56:48.935Z", "usd": "2018-12-15T00:00:00.000Z" }, "market_cap": { "btc": 61868, "eth": 2267403, "usd": 4793905266 }, "market_cap_rank": null, "outstanding_token_value_usd": null, "market_cap_rank_with_rehypothecated": 30, "fully_diluted_valuation": { "btc": 61868, "eth": 2267403, "usd": 4793905266 }, "market_cap_fdv_ratio": 1.0, "total_volume": { "btc": 107.294, "eth": 3931, "usd": 8317546 }, "high_24h": { "btc": 0.02756131, "eth": 1.00272, "usd": 2125.08 }, "low_24h": { "btc": 0.02717062, "eth": 0.99799697, "usd": 2068.79 }, "price_change_24h": -3.316519511214, "price_change_percentage_24h": -0.15656, "price_change_percentage_7d": -0.0669, "price_change_percentage_14d": -9.45938, "price_change_percentage_30d": -8.82256, "price_change_percentage_60d": 1.63545, "price_change_percentage_200d": -37.57849, "price_change_percentage_1y": -14.56267, "market_cap_change_24h": -12121742.79577, "market_cap_change_percentage_24h": -0.25222, "price_change_24h_in_currency": { "btc": -0.000274386252168236, "eth": -0.000212661454704888, "usd": -3.3165195112137553 }, "price_change_percentage_1h_in_currency": { "btc": -0.19183, "eth": 0.00019, "usd": -0.00865 }, "price_change_percentage_24h_in_currency": { "btc": -0.99568, "eth": -0.02127, "usd": -0.15656 }, "price_change_percentage_7d_in_currency": { "btc": -0.89914, "eth": -0.05304, "usd": -0.0669 }, "price_change_percentage_14d_in_currency": { "btc": -5.49184, "eth": -0.04201, "usd": -9.45938 }, "price_change_percentage_30d_in_currency": { "btc": -8.68383, "eth": -0.02751, "usd": -8.82256 }, "price_change_percentage_60d_in_currency": { "btc": -8.8249, "eth": 0.0505, "usd": 1.63545 }, "price_change_percentage_200d_in_currency": { "btc": -17.15793, "eth": -0.10813, "usd": -37.57849 }, "price_change_percentage_1y_in_currency": { "btc": 18.09057, "eth": 0.19761, "usd": -14.56267 }, "market_cap_change_24h_in_currency": { "btc": -635.7460114267669, "eth": -986.7877555103041, "usd": -12121742.795770645 }, "market_cap_change_percentage_24h_in_currency": { "btc": -1.01713, "eth": -0.0435, "usd": -0.25222 }, "total_supply": 2267926.915444636, "max_supply": null, "max_supply_infinite": true, "circulating_supply": 2267926.915444636, "outstanding_supply": null, "last_updated": "2026-05-25T10:09:02.821Z" }, "community_data": { "facebook_likes": null, "reddit_average_posts_48h": 0.0, "reddit_average_comments_48h": 0.0, "reddit_subscribers": 0, "reddit_accounts_active_48h": 0, "telegram_channel_user_count": null }, "developer_data": { "forks": 0, "stars": 0, "subscribers": 0, "total_issues": 0, "closed_issues": 0, "pull_requests_merged": 0, "pull_request_contributors": 0, "code_additions_deletions_4_weeks": { "additions": null, "deletions": null }, "commit_count_4_weeks": 0, "last_4_weeks_commit_activity_series": [] }, "status_updates": [], "last_updated": "2026-05-25T10:09:02.821Z", "tickers": [ { "base": "WETH", "target": "USDC", "market": { "name": "Native", "identifier": "native", "has_trading_incentive": false }, "last": 2114.7318378964214, "volume": 2999.739679821518, "converted_last": { "btc": 0.02728106, "eth": 1.000065, "usd": 2114.1 }, "converted_volume": { "btc": 81.256, "eth": 2979, "usd": 6296774 }, "trust_score": null, "bid_ask_spread_percentage": 0.04287, "timestamp": "2026-05-25T10:04:42+00:00", "last_traded_at": "2026-05-25T10:04:42+00:00", "last_fetch_at": "2026-05-25T10:04:42+00:00", "is_anomaly": false, "is_stale": false, "trade_url": "https://native.org/app/swap/", "token_info_url": null, "coin_id": "weth", "target_coin_id": "usd-coin", "coin_mcap_usd": 4793905265.563903 } ] } } } } } } }, "/coins/{id}/contract/{contract_address}/market_chart": { "get": { "summary": "Coin Historical Chart Data by Token Address", "description": "To get the historical chart data including time in UNIX, price, market cap and 24hrs volume based on asset platform and particular token contract address", "operationId": "contract-address-market-chart", "x-mint": { "href": "/reference/contract-address-market-chart" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Asset platform ID. \n*refers to [`/asset_platforms`](/reference/asset-platforms-list).", "schema": { "type": "string", "default": "ethereum" } }, { "name": "contract_address", "in": "path", "required": true, "description": "The contract address of token.", "schema": { "type": "string", "default": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" } }, { "name": "vs_currency", "in": "query", "required": true, "description": "Target currency of market data. \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).", "schema": { "type": "string", "default": "usd" } }, { "name": "days", "in": "query", "required": true, "description": "Data up to number of days ago. \nYou may use any integer or `max` for number of days.", "schema": { "type": "string", "default": "1" } }, { "name": "interval", "in": "query", "required": false, "description": "Data interval, leave empty for auto granularity.", "schema": { "type": "string", "enum": [ "5m", "hourly", "daily" ] } }, { "name": "precision", "in": "query", "required": false, "description": "Decimal place for currency price value.", "schema": { "type": "string", "enum": [ "full", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18" ] } } ], "responses": { "200": { "description": "Coin historical chart data by token address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsMarketChart" }, "example": { "prices": [ [ 1779619498604, 0.9997624087636037 ], [ 1779619877081, 0.9997817655336941 ] ], "market_caps": [ [ 1779619498604, 76419636272.78033 ], [ 1779619877081, 76424065983.84229 ] ], "total_volumes": [ [ 1779619498604, 9374311493.936354 ], [ 1779619877081, 9390008044.485624 ] ] } } } } } } }, "/coins/{id}/contract/{contract_address}/market_chart/range": { "get": { "summary": "Coin Historical Chart Data within Time Range by Token Address", "description": "To get the historical chart data within certain time range in UNIX along with price, market cap and 24hrs volume based on asset platform and particular token contract address", "operationId": "contract-address-market-chart-range", "x-mint": { "href": "/reference/contract-address-market-chart-range" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Asset platform ID. \n*refers to [`/asset_platforms`](/reference/asset-platforms-list).", "schema": { "type": "string", "default": "ethereum" } }, { "name": "contract_address", "in": "path", "required": true, "description": "The contract address of token.", "schema": { "type": "string", "default": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" } }, { "name": "vs_currency", "in": "query", "required": true, "description": "Target currency of market data. \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).", "schema": { "type": "string", "default": "usd" } }, { "name": "from", "in": "query", "required": true, "description": "Starting date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. \n**Use ISO date string for best compatibility.**", "schema": { "type": "string", "default": "2025-01-01" } }, { "name": "to", "in": "query", "required": true, "description": "Ending date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. \n**Use ISO date string for best compatibility.**", "schema": { "type": "string", "default": "2025-12-31" } }, { "name": "interval", "in": "query", "required": false, "description": "Data interval, leave empty for auto granularity.", "schema": { "type": "string", "enum": [ "5m", "hourly", "daily" ] } }, { "name": "precision", "in": "query", "required": false, "description": "Decimal place for currency price value.", "schema": { "type": "string", "enum": [ "full", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18" ] } } ], "responses": { "200": { "description": "Coin historical chart data within time range by token address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsMarketChart" }, "example": { "prices": [ [ 1735689600000, 1.000540738607754 ], [ 1735776000000, 0.9995995563541714 ] ], "market_caps": [ [ 1735689600000, 43945617394.42927 ], [ 1735776000000, 43740787028.36501 ] ], "total_volumes": [ [ 1735689600000, 6544488766.849924 ], [ 1735776000000, 5447401746.320422 ] ] } } } } } } }, "/coins/{id}/circulating_supply_chart": { "get": { "summary": "Circulating Supply Chart by ID", "description": "To query historical circulating supply of a coin by number of days away from now based on provided coin ID", "operationId": "coins-id-circulating-supply-chart", "x-mint": { "href": "/reference/coins-id-circulating-supply-chart" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "days", "in": "query", "required": true, "description": "Data up to number of days ago. \nValid values: any integer or `max`.", "schema": { "type": "string", "default": "1" } }, { "name": "interval", "in": "query", "required": false, "description": "Data interval.", "schema": { "type": "string", "enum": [ "5m", "hourly", "daily" ] } } ], "responses": { "200": { "description": "Historical circulating supply chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CirculatingSupplyChart" }, "example": { "circulating_supply": [ [ 1779700198931, "20034078.0" ], [ 1779700499891, "20034078.0" ], [ 1779700797940, "20034078.0" ] ] } } } } } } }, "/coins/{id}/circulating_supply_chart/range": { "get": { "summary": "Circulating Supply Chart within Time Range by ID", "description": "To query historical circulating supply of a coin, within a range of timestamp based on the provided coin ID", "operationId": "coins-id-circulating-supply-chart-range", "x-mint": { "href": "/reference/coins-id-circulating-supply-chart-range" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "from", "in": "query", "required": true, "description": "Starting date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. \n**Use ISO date string for best compatibility.**", "schema": { "type": "string", "default": "2025-01-01" } }, { "name": "to", "in": "query", "required": true, "description": "Ending date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. \n**Use ISO date string for best compatibility.**", "schema": { "type": "string", "default": "2025-12-31" } } ], "responses": { "200": { "description": "Historical circulating supply chart data within time range", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CirculatingSupplyChart" }, "example": { "circulating_supply": [ [ 1735689600000, "19803921.0" ], [ 1735776000000, "19804340.0" ], [ 1735862400000, "19804871.0" ] ] } } } } } } }, "/coins/{id}/total_supply_chart": { "get": { "summary": "Total Supply Chart by ID", "description": "To query historical total supply of a coin by number of days away from now based on provided coin ID", "operationId": "coins-id-total-supply-chart", "x-mint": { "href": "/reference/coins-id-total-supply-chart" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "days", "in": "query", "required": true, "description": "Data up to number of days ago. \nValid values: any integer or `max`.", "schema": { "type": "string", "default": "1" } }, { "name": "interval", "in": "query", "required": false, "description": "Data interval.", "schema": { "type": "string", "enum": [ "daily" ] } } ], "responses": { "200": { "description": "Historical total supply chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TotalSupplyChart" }, "example": { "total_supply": [ [ 1779700797940, "20034078.0" ], [ 1779701097614, "20034078.0" ], [ 1779701399178, "20034078.0" ] ] } } } } } } }, "/coins/{id}/total_supply_chart/range": { "get": { "summary": "Total Supply Chart within Time Range by ID", "description": "To query historical total supply of a coin, within a range of timestamp based on the provided coin ID", "operationId": "coins-id-total-supply-chart-range", "x-mint": { "href": "/reference/coins-id-total-supply-chart-range" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "from", "in": "query", "required": true, "description": "Starting date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. \n**Use ISO date string for best compatibility.**", "schema": { "type": "string", "default": "2025-01-01" } }, { "name": "to", "in": "query", "required": true, "description": "Ending date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. \n**Use ISO date string for best compatibility.**", "schema": { "type": "string", "default": "2025-12-31" } } ], "responses": { "200": { "description": "Historical total supply chart data within time range", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TotalSupplyChart" }, "example": { "total_supply": [ [ 1735689600000, "19803921.0" ], [ 1735776000000, "19804340.0" ], [ 1735862400000, "19804871.0" ] ] } } } } } } }, "/coins/list/new": { "get": { "summary": "Recently Added Coins", "description": "To query the latest 200 coins that recently listed on CoinGecko", "operationId": "coins-list-new", "x-mint": { "href": "/reference/coins-list-new" }, "responses": { "200": { "description": "List of recently added coins", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsListNew" }, "example": [ { "id": "upside-down-cat", "symbol": "USDC", "name": "UpSide Down Cat", "activated_at": 1778737128 }, { "id": "chinification", "symbol": "chinify", "name": "Chinification", "activated_at": 1778705764 } ] } } } } } }, "/coins/list": { "get": { "summary": "Coins List", "description": "To query all the supported coins on CoinGecko with coin ID, name and symbol", "operationId": "coins-list", "x-mint": { "href": "/reference/coins-list" }, "parameters": [ { "name": "include_platform", "in": "query", "required": false, "description": "Include platform and token's contract addresses. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "status", "in": "query", "required": false, "description": "Filter by status of coins. \nDefault: active", "schema": { "type": "string", "enum": [ "active", "inactive" ] } } ], "responses": { "200": { "description": "List of coins", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsList" }, "example": [ { "id": "official-trump", "symbol": "trump", "name": "Official Trump", "platforms": { "solana": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN" } }, { "id": "ondo-finance", "symbol": "ondo", "name": "Ondo", "platforms": { "ethereum": "0xfaba6f8e4a5e8ab82f62fe7c39859fa577269be3" } } ] } } } } } }, "/asset_platforms": { "get": { "summary": "Asset Platforms List", "description": "To query all the supported asset platforms (blockchain networks) on CoinGecko", "operationId": "asset-platforms-list", "x-mint": { "href": "/reference/asset-platforms-list" }, "parameters": [ { "name": "filter", "in": "query", "required": false, "description": "Apply relevant filters to results.", "schema": { "type": "string", "enum": [ "nft" ] } } ], "responses": { "200": { "description": "List of asset platforms", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssetPlatforms" }, "example": [ { "id": "solana", "chain_identifier": null, "name": "Solana", "shortname": "Solana", "native_coin_id": "solana", "image": { "thumb": "https://coin-images.coingecko.com/asset_platforms/images/5/thumb/solana.png?1706606708", "small": "https://coin-images.coingecko.com/asset_platforms/images/5/small/solana.png?1706606708", "large": "https://coin-images.coingecko.com/asset_platforms/images/5/large/solana.png?1706606708" } }, { "id": "flow-evm", "chain_identifier": 747, "name": "Flow EVM", "shortname": "", "native_coin_id": "flow", "image": { "thumb": "https://coin-images.coingecko.com/asset_platforms/images/22173/thumb/flow.jpg?1727072603", "small": "https://coin-images.coingecko.com/asset_platforms/images/22173/small/flow.jpg?1727072603", "large": "https://coin-images.coingecko.com/asset_platforms/images/22173/large/flow.jpg?1727072603" } } ] } } } } } }, "/token_lists/{asset_platform_id}/all.json": { "get": { "summary": "Token Lists by Asset Platform ID", "description": "To get full list of tokens of a blockchain network (asset platform) that is supported by [Ethereum token list standard](https://tokenlists.org/)", "operationId": "token-lists", "x-mint": { "href": "/reference/token-lists" }, "parameters": [ { "name": "asset_platform_id", "in": "path", "required": true, "description": "Asset platform ID. \n*refers to [`/asset_platforms`](/reference/asset-platforms-list).", "schema": { "type": "string", "default": "ethereum" } } ], "responses": { "200": { "description": "Token list by asset platform", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenLists" }, "example": { "name": "CoinGecko", "logoURI": "https://static.coingecko.com/gecko-new.svg", "keywords": [ "defi" ], "timestamp": "2026-05-26T04:03:03.404+00:00", "tokens": [ { "chainId": 1, "address": "0x77c6e4a580c0dce4e5c7a17d0bc077188a83a059", "name": "Swerve.fi USD", "symbol": "SWUSD", "decimals": 18, "logoURI": "https://assets.coingecko.com/coins/images/12918/thumb/swerve.png?1696512706" }, { "chainId": 1, "address": "0xf8e57ac2730d3088d98b79209739b0d5ba085a03", "name": "Optopia AI", "symbol": "OPAI", "decimals": 18, "logoURI": "https://assets.coingecko.com/coins/images/39332/thumb/OPAI.jpg?1721777150" } ], "version": { "major": 1491, "minor": 3, "patch": 0 } } } } } } } }, "/coins/categories/list": { "get": { "summary": "Coins Categories List", "description": "To query all the supported coins categories on CoinGecko", "operationId": "coins-categories-list", "x-mint": { "href": "/reference/coins-categories-list" }, "responses": { "200": { "description": "List of coin categories", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CategoriesList" }, "example": [ { "category_id": "coinbase-ventures-portfolio", "name": "Coinbase Ventures Portfolio" }, { "category_id": "gmci-index", "name": "GMCI Index" } ] } } } } } }, "/coins/categories": { "get": { "summary": "Coins Categories List with Market Data", "description": "To query all the coins categories with market data (market cap, volume, etc.) on CoinGecko", "operationId": "coins-categories", "x-mint": { "href": "/reference/coins-categories" }, "parameters": [ { "name": "order", "in": "query", "required": false, "description": "Sort results by field. \nDefault: `market_cap_desc`", "schema": { "type": "string", "enum": [ "market_cap_desc", "market_cap_asc", "name_desc", "name_asc", "market_cap_change_24h_desc", "market_cap_change_24h_asc" ] } } ], "responses": { "200": { "description": "List of coin categories with market data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Categories" }, "example": [ { "id": "smart-contract-platform", "name": "Smart Contract Platform", "market_cap": 2176528015490.1301, "market_cap_change_24h": -0.4907335508040635, "content": "Smart contract platforms are usually blockchains that host smart contracts or decentralized applications.", "top_3_coins_id": [ "bitcoin", "ethereum", "binancecoin" ], "top_3_coins": [ "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png", "https://coin-images.coingecko.com/coins/images/279/small/ethereum.png", "https://coin-images.coingecko.com/coins/images/825/small/bnb-icon2_2x.png" ], "volume_24h": 45616943988.58024, "updated_at": "2026-05-26T10:02:24.777Z" }, { "id": "layer-1", "name": "Layer 1 (L1)", "market_cap": 2152576804747.1516, "market_cap_change_24h": -0.538526079299288, "content": "Layer 1 serves as the primary and autonomous chain on which transactions are directly executed and confirmed.", "top_3_coins_id": [ "bitcoin", "ethereum", "binancecoin" ], "top_3_coins": [ "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png", "https://coin-images.coingecko.com/coins/images/279/small/ethereum.png", "https://coin-images.coingecko.com/coins/images/825/small/bnb-icon2_2x.png" ], "volume_24h": 44289945362.19749, "updated_at": "2026-05-26T10:01:55.213Z" } ] } } } } } }, "/exchanges": { "get": { "summary": "Exchanges List with Data", "description": "To query all the supported exchanges with exchanges' data (ID, name, country, etc.) that have active trading volumes on CoinGecko", "operationId": "exchanges", "x-mint": { "href": "/reference/exchanges" }, "parameters": [ { "name": "per_page", "in": "query", "required": false, "description": "Total results per page. \nDefault: 100. \nValid values: 1...250", "schema": { "type": "number" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault: 1", "schema": { "type": "number" } } ], "responses": { "200": { "description": "List of exchanges with data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Exchanges" }, "example": [ { "id": "gdax", "name": "Coinbase Exchange", "year_established": 2012, "country": "United States", "description": "A leading U.S.-based exchange known for its regulatory compliance, user-friendly interface, and support for fiat-to-crypto transactions.", "url": "https://www.coinbase.com/", "image": "https://coin-images.coingecko.com/markets/images/23/small/Coinbase_Coin_Primary.png?1706864258", "has_trading_incentive": false, "trust_score": 10, "trust_score_rank": 1, "trade_volume_24h_btc": 13692.36253111657 }, { "id": "binance", "name": "Binance", "year_established": 2017, "country": "Cayman Islands", "description": "One of the world's largest cryptocurrency exchanges by trading volume.", "url": "https://www.binance.com/", "image": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274", "has_trading_incentive": false, "trust_score": 10, "trust_score_rank": 2, "trade_volume_24h_btc": 95140.00808634966 } ] } } } } } }, "/exchanges/list": { "get": { "summary": "Exchanges List", "description": "To query all the supported exchanges with ID and name", "operationId": "exchanges-list", "x-mint": { "href": "/reference/exchanges-list" }, "parameters": [ { "name": "status", "in": "query", "required": false, "description": "Filter by status of exchanges. \nDefault: `active`", "schema": { "type": "string", "enum": [ "active", "inactive" ] } } ], "responses": { "200": { "description": "List of exchanges", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExchangesList" }, "example": [ { "id": "binance", "name": "Binance" }, { "id": "bitget", "name": "Bitget" }, { "id": "okex", "name": "OKX" } ] } } } } } }, "/exchanges/{id}": { "get": { "summary": "Exchange Data by ID", "description": "To query exchange's data (name, year established, country, etc.), exchange volume in BTC and top 100 tickers based on exchange's ID", "operationId": "exchanges-id", "x-mint": { "href": "/reference/exchanges-id" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Exchange ID. \n*refers to [`/exchanges/list`](/reference/exchanges-list).", "schema": { "type": "string", "default": "binance" } }, { "name": "dex_pair_format", "in": "query", "required": false, "description": "Set to `symbol` to display DEX pair base and target as symbols. \nDefault: `contract_address`", "schema": { "type": "string", "enum": [ "contract_address", "symbol" ] } } ], "responses": { "200": { "description": "Exchange data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExchangesId" }, "example": { "name": "Binance", "year_established": 2017, "country": "Cayman Islands", "description": "One of the world's largest cryptocurrency exchanges by trading volume.", "url": "https://www.binance.com/", "image": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274", "facebook_url": "https://www.facebook.com/binanceexchange", "reddit_url": "https://www.reddit.com/r/binance/", "telegram_url": "", "slack_url": "", "other_url_1": "https://medium.com/binanceexchange", "other_url_2": "https://steemit.com/@binanceexchange", "twitter_handle": "binance", "has_trading_incentive": false, "centralized": true, "public_notice": "", "alert_notice": "", "trust_score": 10, "trust_score_rank": 2, "coins": 435, "pairs": 1391, "trade_volume_24h_btc": 95073.68489926813, "tickers": [ { "base": "USDC", "target": "USDT", "market": { "name": "Binance", "identifier": "binance", "has_trading_incentive": false }, "last": 1.00087, "volume": 2089887585.0, "converted_last": { "btc": 1.301e-05, "eth": 0.00047417, "usd": 0.999569 }, "converted_volume": { "btc": 27187, "eth": 990971, "usd": 2088986570 }, "trust_score": null, "bid_ask_spread_percentage": 0.010999, "timestamp": "2026-05-26T10:21:17+00:00", "last_traded_at": "2026-05-26T10:21:17+00:00", "last_fetch_at": "2026-05-26T10:23:00+00:00", "is_anomaly": false, "is_stale": false, "trade_url": "https://www.binance.com/en/trade/USDC_USDT?ref=37754157", "token_info_url": null, "coin_id": "usd-coin", "target_coin_id": "tether", "coin_mcap_usd": 76286248956.20789 }, { "base": "BTC", "target": "USDT", "market": { "name": "Binance", "identifier": "binance", "has_trading_incentive": false }, "last": 76960.0, "volume": 9037.21995, "converted_last": { "btc": 1.000348, "eth": 36.491428, "usd": 76860 }, "converted_volume": { "btc": 9040, "eth": 329781, "usd": 694600292 }, "trust_score": null, "bid_ask_spread_percentage": 0.010013, "timestamp": "2026-05-26T10:21:39+00:00", "last_traded_at": "2026-05-26T10:21:39+00:00", "last_fetch_at": "2026-05-26T10:22:33+00:00", "is_anomaly": false, "is_stale": false, "trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157", "token_info_url": null, "coin_id": "bitcoin", "target_coin_id": "tether", "coin_mcap_usd": 1536007329547.9153 } ], "status_updates": [ { "description": "Juventus and Paris Saint-Germain Fan Tokens on Binance Launchpool!", "category": "general", "created_at": "2020-12-14T11:18:49.085Z", "user": "Darc", "user_title": "Marketing", "pin": false, "project": { "type": "Market", "id": "binance", "name": "Binance", "image": { "thumb": "https://coin-images.coingecko.com/markets/images/52/thumb/binance.jpg?1706864274", "small": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274", "large": "https://coin-images.coingecko.com/markets/images/52/large/binance.jpg?1706864274" } } } ] } } } } } } }, "/exchanges/{id}/tickers": { "get": { "summary": "Exchange Tickers by ID", "description": "To query exchange's tickers based on exchange's ID", "operationId": "exchanges-id-tickers", "x-mint": { "href": "/reference/exchanges-id-tickers" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Exchange ID. \n*refers to [`/exchanges/list`](/reference/exchanges-list).", "schema": { "type": "string", "default": "binance" } }, { "name": "coin_ids", "in": "query", "required": false, "description": "Filter tickers by coin IDs, comma-separated if querying more than 1 coin. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string" } }, { "name": "include_exchange_logo", "in": "query", "required": false, "description": "Include exchange logo. \nDefault: false", "schema": { "type": "boolean" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results.", "schema": { "type": "number" } }, { "name": "depth", "in": "query", "required": false, "description": "Include 2% orderbook depth (cost_to_move_up_usd and cost_to_move_down_usd). \nDefault: false", "schema": { "type": "boolean" } }, { "name": "order", "in": "query", "required": false, "description": "Sort the order of responses. \nDefault: `trust_score_desc`", "schema": { "type": "string", "enum": [ "market_cap_asc", "market_cap_desc", "trust_score_desc", "trust_score_asc", "volume_desc", "volume_asc", "base_target" ] } }, { "name": "dex_pair_format", "in": "query", "required": false, "description": "Set to `symbol` to display DEX pair base and target as symbols. \nDefault: `contract_address`", "schema": { "type": "string", "enum": [ "contract_address", "symbol" ] } } ], "responses": { "200": { "description": "Exchange tickers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoinsIdTickers" }, "example": { "name": "Binance", "tickers": [ { "base": "BTC", "target": "USDT", "market": { "name": "Binance", "identifier": "binance", "has_trading_incentive": false, "logo": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274" }, "last": 77172.88, "volume": 9243.62632, "cost_to_move_up_usd": 21983152.092277337, "cost_to_move_down_usd": 19695552.01703934, "converted_last": { "btc": 0.99912594, "eth": 36.349604, "usd": 77080 }, "converted_volume": { "btc": 9236, "eth": 336002, "usd": 712501236 }, "trust_score": null, "bid_ask_spread_percentage": 0.010013, "timestamp": "2026-05-26T10:32:37+00:00", "last_traded_at": "2026-05-26T10:32:37+00:00", "last_fetch_at": "2026-05-26T10:33:31+00:00", "is_anomaly": false, "is_stale": false, "trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157", "token_info_url": null, "coin_id": "bitcoin", "target_coin_id": "tether", "coin_mcap_usd": 1545160286928.7285 }, { "base": "BTC", "target": "USDC", "market": { "name": "Binance", "identifier": "binance", "has_trading_incentive": false, "logo": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274" }, "last": 77189.96, "volume": 2736.40541, "cost_to_move_up_usd": 5747075.588603265, "cost_to_move_down_usd": 4869585.811774237, "converted_last": { "btc": 1.000158, "eth": 36.386207, "usd": 77159 }, "converted_volume": { "btc": 2737, "eth": 99567, "usd": 211138535 }, "trust_score": null, "bid_ask_spread_percentage": 0.010013, "timestamp": "2026-05-26T10:32:01+00:00", "last_traded_at": "2026-05-26T10:32:01+00:00", "last_fetch_at": "2026-05-26T10:33:30+00:00", "is_anomaly": false, "is_stale": false, "trade_url": "https://www.binance.com/en/trade/BTC_USDC?ref=37754157", "token_info_url": null, "coin_id": "bitcoin", "target_coin_id": "usd-coin", "coin_mcap_usd": 1545160286928.7285 } ] } } } } } } }, "/exchanges/{id}/volume_chart": { "get": { "summary": "Exchange Volume Chart by ID", "description": "To query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange's ID", "operationId": "exchanges-id-volume-chart", "x-mint": { "href": "/reference/exchanges-id-volume-chart" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Exchange ID or derivative exchange ID. \n*refers to [`/exchanges/list`](/reference/exchanges-list) or [`/derivatives/exchanges/list`](/reference/derivatives-exchanges-list).", "schema": { "type": "string", "default": "binance" } }, { "name": "days", "in": "query", "required": true, "description": "Data up to number of days ago.", "schema": { "type": "string", "default": "1", "enum": [ "1", "7", "14", "30", "90", "180", "365" ] } } ], "responses": { "200": { "description": "Exchange volume chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExchangeVolumeChart" }, "example": [ [ 1779719400000, "76327.6889417086372104" ], [ 1779720000000, "76335.761747668369059" ] ] } } } } } }, "/exchanges/{id}/volume_chart/range": { "get": { "summary": "Exchange Volume Chart within Time Range by ID", "description": "To query the historical volume chart data in BTC by specifying date range in UNIX based on exchange's ID", "operationId": "exchanges-id-volume-chart-range", "x-mint": { "href": "/reference/exchanges-id-volume-chart-range" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Exchange ID or derivative exchange ID. \n*refers to [`/exchanges/list`](/reference/exchanges-list) or [`/derivatives/exchanges/list`](/reference/derivatives-exchanges-list).", "schema": { "type": "string", "default": "binance" } }, { "name": "from", "in": "query", "required": true, "description": "Starting date in UNIX timestamp.", "schema": { "type": "number", "default": "1767196800" } }, { "name": "to", "in": "query", "required": true, "description": "Ending date in UNIX timestamp.", "schema": { "type": "number", "default": "1769702400" } } ], "responses": { "200": { "description": "Exchange volume chart data within time range", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExchangeVolumeChart" }, "example": [ [ 1767282600000.0, "100719.0303690094832477" ], [ 1767369000000.0, "132387.93566259711126" ] ] } } } } } }, "/derivatives": { "get": { "summary": "Derivatives Tickers List", "description": "To query all the tickers from derivatives exchanges on CoinGecko", "operationId": "derivatives-tickers", "x-mint": { "href": "/reference/derivatives-tickers" }, "responses": { "200": { "description": "List of derivative tickers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DerivativesTickers" }, "example": [ { "market": "Binance (Futures)", "symbol": "BTCUSDT", "index_id": "BTC", "price": "77034.8", "price_percentage_change_24h": -1.1733397846861013, "contract_type": "perpetual", "index": 76691.4276087, "basis": -0.138769748300737, "spread": 0.01, "funding_rate": 0.004308, "open_interest": 7497508223.83, "volume_24h": 9623150393.3656, "last_traded_at": 1779807819, "expired_at": null }, { "market": "Binance (Futures)", "symbol": "ETHUSDT", "index_id": "ETH", "price": "2113.92", "price_percentage_change_24h": -1.213464572845443, "contract_type": "perpetual", "index": 2099.55744186, "basis": -0.19217332857957786, "spread": 0.01, "funding_rate": 0.005327, "open_interest": 4563725156.36, "volume_24h": 7655835901.46112, "last_traded_at": 1779807818, "expired_at": null } ] } } } } } }, "/derivatives/exchanges": { "get": { "summary": "Derivatives Exchanges List with Data", "description": "To query all the derivatives exchanges with related data (ID, name, open interest, ...) on CoinGecko", "operationId": "derivatives-exchanges", "x-mint": { "href": "/reference/derivatives-exchanges" }, "parameters": [ { "name": "order", "in": "query", "required": false, "description": "Sort order of responses. \nDefault: `open_interest_btc_desc`", "schema": { "type": "string", "enum": [ "name_asc", "name_desc", "open_interest_btc_asc", "open_interest_btc_desc", "trade_volume_24h_btc_asc", "trade_volume_24h_btc_desc" ] } }, { "name": "per_page", "in": "query", "required": false, "description": "Total results per page.", "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of derivative exchanges with data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DerivativesExchanges" }, "example": [ { "name": "Binance (Futures)", "id": "binance_futures", "open_interest_btc": 332790.5, "trade_volume_24h_btc": "588597.24", "number_of_perpetual_pairs": 592, "number_of_futures_pairs": 72, "image": "https://coin-images.coingecko.com/markets/images/466/small/binance_futures.jpg?1706864452", "year_established": 2019, "country": "Cayman Islands", "description": "", "url": "https://www.binance.com/" }, { "name": "Bybit (Futures)", "id": "bybit", "open_interest_btc": 148377.99, "trade_volume_24h_btc": "162793.82", "number_of_perpetual_pairs": 673, "number_of_futures_pairs": 68, "image": "https://coin-images.coingecko.com/markets/images/460/small/photo_2021-08-12_18-27-50.jpg?1706864447", "year_established": 2018, "country": "Seychelles", "description": "Bybit is the world's second-largest cryptocurrency exchange by trading volume, serving a global community of over 60 million users.", "url": "https://www.bybit.com" } ] } } } } } }, "/derivatives/exchanges/{id}": { "get": { "summary": "Derivatives Exchange Data by ID", "description": "To query the derivatives exchange's related data (name, open interest, trade volume, ...) based on the exchange's ID", "operationId": "derivatives-exchanges-id", "x-mint": { "href": "/reference/derivatives-exchanges-id" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Derivative exchange ID. \n*refers to [`/derivatives/exchanges/list`](/reference/derivatives-exchanges-list).", "schema": { "type": "string", "default": "binance_futures" } }, { "name": "include_tickers", "in": "query", "required": false, "description": "Include tickers data. \nDefault: tickers data is not included.", "schema": { "type": "string", "enum": [ "all", "unexpired" ] } } ], "responses": { "200": { "description": "Derivative exchange data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DerivativesExchangesID" }, "example": { "name": "Binance (Futures)", "open_interest_btc": 331945.73, "trade_volume_24h_btc": "587332.45", "number_of_perpetual_pairs": 592, "number_of_futures_pairs": 72, "image": "https://coin-images.coingecko.com/markets/images/466/small/binance_futures.jpg?1706864452", "year_established": 2019, "country": "Cayman Islands", "description": "", "url": "https://www.binance.com/", "tickers": [ { "symbol": "0GUSDT", "base": "0G", "target": "USDT", "coin_id": "zero-gravity", "target_coin_id": "tether", "trade_url": "https://www.binance.com/en/futures/0GUSDT", "contract_type": "perpetual", "last": 0.473, "h24_percentage_change": -1.149, "index": 0.47388788, "index_basis_percentage": -0.066, "bid_ask_spread": 0.0004225649693639931, "funding_rate": 0.005, "open_interest_usd": 7505441.41551142, "h24_volume": 6822128.0, "converted_volume": { "btc": "42.0799463192663717990920674226785386061670893822933102624", "eth": "1536.67707296907453613610493674728740267430011541374571065838147892993088", "usd": "3222911.4917378246159226528" }, "converted_last": { "btc": "0.0000061681554962419895667586517612508206539318947668958", "eth": "0.00022524893595797008442763092934452232539088978034621245902427827196", "usd": "0.4724202612055687926" }, "last_traded": 1779809107, "expired_at": null }, { "symbol": "1000000BOBUSDT", "base": "1000000BOB", "target": "USDT", "coin_id": "build-on-bnb", "target_coin_id": "tether", "trade_url": "https://www.binance.com/en/futures/1000000BOBUSDT", "contract_type": "perpetual", "last": 0.015, "h24_percentage_change": -3.331, "index": 0.01540057, "index_basis_percentage": 0.134, "bid_ask_spread": 0.001298701298701358, "funding_rate": 0.005, "open_interest_usd": 916291.34908113, "h24_volume": 44830706.0, "converted_volume": { "btc": "8.975935927077560026865126277039614163512381271518795395788", "eth": "327.26598326618858627284207444108921232850344104115627132937452733698970504", "usd": "688649.790093212658495595932" }, "converted_last": { "btc": "0.000000200218482552506757909748873395828612726116364786198", "eth": "0.00000730004080832875097422829063724959433671429223178319501212794925284", "usd": "0.015361118562201823422" }, "last_traded": 1779808948, "expired_at": null } ] } } } } } } }, "/derivatives/exchanges/list": { "get": { "summary": "Derivatives Exchanges List", "description": "To query all the supported derivatives exchanges with ID and name on CoinGecko", "operationId": "derivatives-exchanges-list", "x-mint": { "href": "/reference/derivatives-exchanges-list" }, "responses": { "200": { "description": "List of derivative exchange identifiers and names", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DerivativesExchangesList" }, "example": [ { "id": "binance_futures", "name": "Binance (Futures)" }, { "id": "bybit", "name": "Bybit (Futures)" } ] } } } } } }, "/entities/list": { "get": { "summary": "Entities List", "description": "To query all the supported entities on CoinGecko with entity ID, name, symbol, and country", "operationId": "entities-list", "x-mint": { "href": "/reference/entities-list" }, "parameters": [ { "name": "entity_type", "in": "query", "required": false, "description": "Filter by entity type.", "schema": { "type": "string", "enum": [ "company", "government" ] } }, { "name": "per_page", "in": "query", "required": false, "description": "Total results per page. \nDefault value: 100 \nValid values: 1...250", "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of entities with ID, name, symbol, and country", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EntitiesList" }, "example": [ { "id": "texas", "symbol": "", "name": "Texas", "country": "US" }, { "id": "digipowerx", "symbol": "DGX.V", "name": "DigiPowerX", "country": "US" } ] } } } } } }, "/{entity}/public_treasury/{coin_id}": { "get": { "summary": "Crypto Treasury Holdings by Coin ID", "description": "To query public companies' and governments' cryptocurrency holdings by coin ID", "operationId": "companies-public-treasury", "x-mint": { "href": "/reference/companies-public-treasury" }, "parameters": [ { "name": "entity", "in": "path", "required": true, "description": "Public company or government entity.", "schema": { "type": "string", "default": "companies", "enum": [ "companies", "governments" ] } }, { "name": "coin_id", "in": "path", "required": true, "description": "Coin ID. \ne.g. `bitcoin`, `ethereum`, `solana`, `binancecoin`", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "per_page", "in": "query", "required": false, "description": "Total results per page. \nDefault value: 250 \nValid values: 1...250", "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "order", "in": "query", "required": false, "description": "Sort order for results. \nDefault: `total_holdings_usd_desc`", "schema": { "type": "string", "enum": [ "total_holdings_usd_desc", "total_holdings_usd_asc" ] } } ], "responses": { "200": { "description": "Public companies or governments crypto treasury holdings data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicTreasury" }, "example": { "total_holdings": 1272129.0267804659, "total_value_usd": 97225044888.65527, "market_cap_dominance": 6.06, "companies": [ { "name": "Strategy", "symbol": "MSTR.US", "country": "US", "total_holdings": 843738.0, "total_entry_value_usd": 63870055699.0, "total_current_value_usd": 64484706340.107254, "percentage_of_total_supply": 4.018 }, { "name": "XXI", "symbol": "XXI.US", "country": "US", "total_holdings": 43514.0, "total_entry_value_usd": 0.0, "total_current_value_usd": 3325662126.967645, "percentage_of_total_supply": 0.207 } ] } } } } } } }, "/public_treasury/{entity_id}": { "get": { "summary": "Crypto Treasury Holdings by Entity ID", "description": "To query public companies' and governments' cryptocurrency holdings by entity ID", "operationId": "public-treasury-entity", "x-mint": { "href": "/reference/public-treasury-entity" }, "parameters": [ { "name": "entity_id", "in": "path", "required": true, "description": "Public company or government entity ID. \n*refers to [`/entities/list`](/reference/entities-list).", "schema": { "type": "string", "default": "strategy" } }, { "name": "holding_amount_change", "in": "query", "required": false, "description": "Include holding amount change for specified timeframes, comma-separated if querying more than 1 timeframe. \nValid values: `7d`, `14d`, `30d`, `90d`, `1y`, `ytd`", "schema": { "type": "string" } }, { "name": "holding_change_percentage", "in": "query", "required": false, "description": "Include holding change percentage for specified timeframes, comma-separated if querying more than 1 timeframe. \nValid values: `7d`, `14d`, `30d`, `90d`, `1y`, `ytd`", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Public company or government crypto treasury holdings data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicTreasuryEntity" }, "example": { "name": "Strategy", "id": "strategy", "type": "company", "symbol": "MSTR.US", "country": "US", "website_url": "https://www.strategy.com/", "twitter_screen_name": "Strategy", "total_treasury_value_usd": 64383151578.86817, "unrealized_pnl": 513095879.8681717, "m_nav": 1.03, "total_asset_value_per_share_usd": 179.74079167746558, "holdings": [ { "coin_id": "bitcoin", "amount": 843738.0, "percentage_of_total_supply": 4.018, "amount_per_share": 0.002355494137353434, "entity_value_usd_percentage": 100.0, "current_value_usd": 64383151578.86817, "total_entry_value_usd": 63870055699.0, "average_entry_value_usd": 75698.9203982753, "unrealized_pnl": 513095879.8681717, "holding_amount_change": { "7d": 0.0, "14d": 24869.0, "30d": 28677.0, "90d": 126016.0, "1y": 263488.0, "ytd": 171238.0 }, "holding_change_percentage": { "7d": 0.0, "14d": 3.037, "30d": 3.518, "90d": 17.558, "1y": 45.409, "ytd": 25.463 } } ] } } } } } } }, "/public_treasury/{entity_id}/{coin_id}/holding_chart": { "get": { "summary": "Crypto Treasury Holdings Historical Chart Data by ID", "description": "To query historical cryptocurrency holdings chart of public companies and governments by entity ID and coin ID", "operationId": "public-treasury-entity-chart", "x-mint": { "href": "/reference/public-treasury-entity-chart" }, "parameters": [ { "name": "entity_id", "in": "path", "required": true, "description": "Public company or government entity ID. \n*refers to [`/entities/list`](/reference/entities-list).", "schema": { "type": "string", "default": "strategy" } }, { "name": "coin_id", "in": "path", "required": true, "description": "Coin ID. \ne.g. `bitcoin`, `ethereum`, `solana`, `binancecoin`", "schema": { "type": "string", "default": "bitcoin" } }, { "name": "days", "in": "query", "required": true, "description": "Data up to number of days ago. \nValid values: `7`, `14`, `30`, `90`, `180`, `365`, `730`, `max`", "schema": { "type": "string", "default": "365" } }, { "name": "include_empty_intervals", "in": "query", "required": false, "description": "Include empty intervals with no transaction data. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Crypto treasury holdings historical chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicTreasuryEntityChart" }, "example": { "holdings": [ [ 1748736000000, 580955.0 ], [ 1749340800000, 582000.0 ] ], "holding_value_in_usd": [ [ 1748736000000, 60818730878.617355 ], [ 1749340800000, 61506606585.45032 ] ] } } } } } } }, "/public_treasury/{entity_id}/transaction_history": { "get": { "summary": "Crypto Treasury Transaction History by Entity ID", "description": "To query public companies' and governments' cryptocurrency transaction history by entity ID", "operationId": "public-treasury-transaction-history", "x-mint": { "href": "/reference/public-treasury-transaction-history" }, "parameters": [ { "name": "entity_id", "in": "path", "required": true, "description": "Public company or government entity ID. \n*refers to [`/entities/list`](/reference/entities-list).", "schema": { "type": "string", "default": "strategy" } }, { "name": "per_page", "in": "query", "required": false, "description": "Total results per page. \nDefault value: 100 \nValid values: 1...250", "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "order", "in": "query", "required": false, "description": "Sort order of transactions. \nDefault: `date_desc`", "schema": { "type": "string", "enum": [ "date_desc", "date_asc", "holding_net_change_desc", "holding_net_change_asc", "transaction_value_usd_desc", "transaction_value_usd_asc", "average_cost_desc", "average_cost_asc" ] } }, { "name": "coin_ids", "in": "query", "required": false, "description": "Filter transactions by coin IDs, comma-separated if querying more than 1 coin. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Crypto treasury transaction history data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicTreasuryTransactionHistory" }, "example": { "transactions": [ { "date": 1779062400000, "source_url": "https://assets.contentstack.io/v3/assets/bltf8d808d9b8cebd37/bltc0d0f9d2d325a368/6a0a710811de4f7e170ba045/form-8-k_05-18-2026.pdf", "coin_id": "bitcoin", "type": "buy", "holding_net_change": 24869.0, "transaction_value_usd": 2014015965.0, "holding_balance": 843738.0, "average_entry_value_usd": 80985.0 }, { "date": 1778457600000, "source_url": "https://assets.contentstack.io/v3/assets/bltf8d808d9b8cebd37/blt7653ead16575975e/6a01462c750c63f12be32cf8/form-8-k_05-11-2026.pdf", "coin_id": "bitcoin", "type": "buy", "holding_net_change": 535.0, "transaction_value_usd": 42981900.0, "holding_balance": 818869.0, "average_entry_value_usd": 80340.0 } ] } } } } } } }, "/nfts/list": { "get": { "summary": "NFTs List", "description": "To query all supported NFTs with ID, contract address, name, asset platform ID and symbol on CoinGecko", "operationId": "nfts-list", "x-mint": { "href": "/reference/nfts-list" }, "parameters": [ { "name": "order", "in": "query", "required": false, "description": "Sort order of responses.", "schema": { "type": "string", "enum": [ "h24_volume_usd_asc", "h24_volume_usd_desc", "h24_volume_native_asc", "h24_volume_native_desc", "floor_price_native_asc", "floor_price_native_desc", "market_cap_native_asc", "market_cap_native_desc", "market_cap_usd_asc", "market_cap_usd_desc" ] } }, { "name": "per_page", "in": "query", "required": false, "description": "Total results per page. \nValid values: 1...250", "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of supported NFTs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NFTsList" }, "example": [ { "id": "cryptopunks", "contract_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB", "name": "CryptoPunks", "asset_platform_id": "ethereum", "symbol": "PUNK" }, { "id": "bored-ape-yacht-club", "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d", "name": "Bored Ape Yacht Club", "asset_platform_id": "ethereum", "symbol": "BAYC" } ] } } } } } }, "/nfts/{id}": { "get": { "summary": "NFTs Collection Data by ID", "description": "To query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection ID", "operationId": "nfts-id", "x-mint": { "href": "/reference/nfts-id" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "NFT collection ID. \n*refers to [`/nfts/list`](/reference/nfts-list).", "schema": { "type": "string", "default": "pudgy-penguins" } } ], "responses": { "200": { "description": "NFT collection data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NFTData" }, "example": { "id": "pudgy-penguins", "web_slug": "pudgy-penguins", "contract_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8", "asset_platform_id": "ethereum", "name": "Pudgy Penguins", "symbol": "PPG", "image": { "small": "https://coin-images.coingecko.com/nft_contracts/images/38/small/pudgy.jpg?1730778323", "small_2x": "https://coin-images.coingecko.com/nft_contracts/images/38/small_2x/pudgy.jpg?1730778323" }, "banner_image": "https://coin-images.coingecko.com/nft_contracts/images/38/pudgy-penguins-banner.jpg?1730778702", "description": "

What Is the Pudgy Penguins NFT Collection?

\n\n

Pudgy Penguins is a collection of 8,888 unique NFTs featuring cute cartoon penguins, which are generated from a collection of 150 different hand-drawn traits.", "native_currency": "ethereum", "native_currency_symbol": "ETH", "market_cap_rank": 3, "floor_price": { "native_currency": 4.67, "usd": 9713.91 }, "market_cap": { "native_currency": 41507, "usd": 86337207 }, "volume_24h": { "native_currency": 28.01, "usd": 58262 }, "floor_price_in_usd_24h_percentage_change": -1.78233, "floor_price_24h_percentage_change": { "usd": -1.782332967792004, "native_currency": -0.6361858762952403 }, "market_cap_24h_percentage_change": { "usd": -1.782332967792065, "native_currency": -0.6361858762952404 }, "volume_24h_percentage_change": { "usd": -41.588610680147845, "native_currency": -40.90698133583369 }, "number_of_unique_addresses": 5174.0, "number_of_unique_addresses_24h_percentage_change": -0.01932, "volume_in_usd_24h_percentage_change": -41.58861, "total_supply": 8888.0, "one_day_sales": 6.0, "one_day_sales_24h_percentage_change": -40.0, "one_day_average_sale_price": 4.668316666666667, "one_day_average_sale_price_24h_percentage_change": -1.511635559722812, "links": { "homepage": "https://www.pudgypenguins.com/", "twitter": "https://twitter.com/pudgypenguins", "discord": "https://discord.gg/pudgypenguins" }, "floor_price_7d_percentage_change": { "usd": -2.6085983246414655, "native_currency": -1.1974800093036855 }, "floor_price_14d_percentage_change": { "usd": -24.816051386825123, "native_currency": -16.157991023339317 }, "floor_price_30d_percentage_change": { "usd": -20.72768500482924, "native_currency": -12.366254928188072 }, "floor_price_60d_percentage_change": { "usd": 15.176366939745344, "native_currency": 13.07508549033547 }, "floor_price_1y_percentage_change": { "usd": -60.37112564100154, "native_currency": -51.85567113402062 }, "explorers": [ { "name": "Etherscan", "link": "https://etherscan.io/token/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8" }, { "name": "Ethplorer", "link": "https://ethplorer.io/address/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8" } ], "user_favorites_count": 10135, "ath": { "native_currency": 36.33, "usd": 145728 }, "ath_change_percentage": { "native_currency": -87.1456099642169, "usd": -93.3388047739623 }, "ath_date": { "native_currency": "2024-12-17T07:50:05.897Z", "usd": "2024-12-17T08:35:07.390Z" } } } } } } } }, "/nfts/{asset_platform_id}/contract/{contract_address}": { "get": { "summary": "NFTs Collection Data by Contract Address", "description": "To query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection contract address and respective asset platform", "operationId": "nfts-contract-address", "x-mint": { "href": "/reference/nfts-contract-address" }, "parameters": [ { "name": "asset_platform_id", "in": "path", "required": true, "description": "Asset platform ID. \n*refers to [`/asset_platforms`](/reference/asset-platforms-list).", "schema": { "type": "string", "default": "ethereum" } }, { "name": "contract_address", "in": "path", "required": true, "description": "Contract address of the NFT collection.", "schema": { "type": "string", "default": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8" } } ], "responses": { "200": { "description": "NFT collection data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NFTData" }, "example": { "id": "pudgy-penguins", "web_slug": "pudgy-penguins", "contract_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8", "asset_platform_id": "ethereum", "name": "Pudgy Penguins", "symbol": "PPG", "image": { "small": "https://coin-images.coingecko.com/nft_contracts/images/38/small/pudgy.jpg?1730778323", "small_2x": "https://coin-images.coingecko.com/nft_contracts/images/38/small_2x/pudgy.jpg?1730778323" }, "banner_image": "https://coin-images.coingecko.com/nft_contracts/images/38/pudgy-penguins-banner.jpg?1730778702", "description": "

What Is the Pudgy Penguins NFT Collection?

\n\n

Pudgy Penguins is a collection of 8,888 unique NFTs featuring cute cartoon penguins, which are generated from a collection of 150 different hand-drawn traits.", "native_currency": "ethereum", "native_currency_symbol": "ETH", "market_cap_rank": 3, "floor_price": { "native_currency": 4.67, "usd": 9708.85 }, "market_cap": { "native_currency": 41507, "usd": 86292262 }, "volume_24h": { "native_currency": 28.01, "usd": 58232 }, "floor_price_in_usd_24h_percentage_change": -1.78233, "floor_price_24h_percentage_change": { "usd": -1.782332967792004, "native_currency": -0.6361858762952403 }, "market_cap_24h_percentage_change": { "usd": -1.782332967792065, "native_currency": -0.6361858762952404 }, "volume_24h_percentage_change": { "usd": -41.588610680147845, "native_currency": -40.90698133583369 }, "number_of_unique_addresses": 5174.0, "number_of_unique_addresses_24h_percentage_change": -0.01932, "volume_in_usd_24h_percentage_change": -41.58861, "total_supply": 8888.0, "one_day_sales": 6.0, "one_day_sales_24h_percentage_change": -40.0, "one_day_average_sale_price": 4.668316666666667, "one_day_average_sale_price_24h_percentage_change": -1.511635559722812, "links": { "homepage": "https://www.pudgypenguins.com/", "twitter": "https://twitter.com/pudgypenguins", "discord": "https://discord.gg/pudgypenguins" }, "floor_price_7d_percentage_change": { "usd": -2.6085983246414655, "native_currency": -1.1974800093036855 }, "floor_price_14d_percentage_change": { "usd": -24.816051386825123, "native_currency": -16.157991023339317 }, "floor_price_30d_percentage_change": { "usd": -20.72768500482924, "native_currency": -12.366254928188072 }, "floor_price_60d_percentage_change": { "usd": 15.176366939745344, "native_currency": 13.07508549033547 }, "floor_price_1y_percentage_change": { "usd": -60.37112564100154, "native_currency": -51.85567113402062 }, "explorers": [ { "name": "Etherscan", "link": "https://etherscan.io/token/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8" }, { "name": "Ethplorer", "link": "https://ethplorer.io/address/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8" } ], "user_favorites_count": 10135, "ath": { "native_currency": 36.33, "usd": 145728 }, "ath_change_percentage": { "native_currency": -87.1456099642169, "usd": -93.3388047739623 }, "ath_date": { "native_currency": "2024-12-17T07:50:05.897Z", "usd": "2024-12-17T08:35:07.390Z" } } } } } } } }, "/nfts/markets": { "get": { "summary": "NFTs List with Market Data", "description": "To query all the supported NFT collections with floor price, market cap, volume and market related data on CoinGecko", "operationId": "nfts-markets", "x-mint": { "href": "/reference/nfts-markets" }, "parameters": [ { "name": "asset_platform_id", "in": "query", "required": false, "description": "Filter result by asset platform (blockchain network). \n*refers to [`/asset_platforms`](/reference/asset-platforms-list) filter=`nft`.", "schema": { "type": "string" } }, { "name": "order", "in": "query", "required": false, "description": "Sort results by field. \nDefault: `market_cap_usd_desc`", "schema": { "type": "string", "enum": [ "h24_volume_native_asc", "h24_volume_native_desc", "h24_volume_usd_asc", "h24_volume_usd_desc", "market_cap_usd_asc", "market_cap_usd_desc" ] } }, { "name": "per_page", "in": "query", "required": false, "description": "Total results per page. \nDefault value: 100 \nValid values: 1...250", "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of NFT collections with market data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NFTsMarkets" }, "example": [ { "id": "cryptopunks", "contract_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB", "asset_platform_id": "ethereum", "name": "CryptoPunks", "symbol": "PUNK", "image": { "small": "https://coin-images.coingecko.com/nft_contracts/images/270/small/cryptopunks.png?1707287245", "small_2x": "https://coin-images.coingecko.com/nft_contracts/images/270/small_2x/cryptopunks.png?1707287245" }, "description": "

What Is the CryptoPunks NFT Collection?

\r\n\r\n

CryptoPunks is an Ethereum-based NFT collection of 10,000 unique art characters.", "native_currency": "ethereum", "native_currency_symbol": "ETH", "floor_price": { "native_currency": 32.99, "usd": 68598 }, "market_cap": { "native_currency": 329702, "usd": 685567614 }, "volume_24h": { "native_currency": 0.0, "usd": 0.0 }, "floor_price_in_usd_24h_percentage_change": -2.61445, "floor_price_24h_percentage_change": { "usd": -2.614447557256636, "native_currency": -0.7222389407162203 }, "market_cap_24h_percentage_change": { "usd": -2.6144475572566117, "native_currency": -0.7222389407162202 }, "volume_24h_percentage_change": { "usd": -100.0, "native_currency": -100.0 }, "number_of_unique_addresses": 100.0, "number_of_unique_addresses_24h_percentage_change": 0.0, "volume_in_usd_24h_percentage_change": -100.0, "total_supply": 9994.0, "one_day_sales": null, "one_day_sales_24h_percentage_change": 0.0, "one_day_average_sale_price": null, "one_day_average_sale_price_24h_percentage_change": 0.0 }, { "id": "bored-ape-yacht-club", "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d", "asset_platform_id": "ethereum", "name": "Bored Ape Yacht Club", "symbol": "BAYC", "image": { "small": "https://coin-images.coingecko.com/nft_contracts/images/20/small/bored-ape-yacht-club.png?1707287177", "small_2x": "https://coin-images.coingecko.com/nft_contracts/images/20/small_2x/bored-ape-yacht-club.png?1707287177" }, "description": "

What Is the Bored Ape Yacht Club NFT Collection?

\r\n\r\n

The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs, which showcase a series of apes with different characteristics and expressions.", "native_currency": "ethereum", "native_currency_symbol": "ETH", "floor_price": { "native_currency": 8.69, "usd": 18036.28 }, "market_cap": { "native_currency": 86883, "usd": 180326699 }, "volume_24h": { "native_currency": 166.12, "usd": 344783 }, "floor_price_in_usd_24h_percentage_change": -4.33779, "floor_price_24h_percentage_change": { "usd": -4.33779438865101, "native_currency": -1.7857142857131758 }, "market_cap_24h_percentage_change": { "usd": -4.337794388651022, "native_currency": -1.7857142857131754 }, "volume_24h_percentage_change": { "usd": 10.090203438665934, "native_currency": 27.149001523165122 }, "number_of_unique_addresses": 5653.0, "number_of_unique_addresses_24h_percentage_change": -0.05304, "volume_in_usd_24h_percentage_change": 10.0902, "total_supply": 9998.0, "one_day_sales": 18.0, "one_day_sales_24h_percentage_change": 50.0, "one_day_average_sale_price": 9.228827722222222, "one_day_average_sale_price_24h_percentage_change": -15.23399898455658 } ] } } } } } }, "/nfts/{id}/market_chart": { "get": { "summary": "NFTs Collection Historical Chart Data by ID", "description": "To query historical market data of a NFT collection, including floor price, market cap, and 24hr volume, by number of days away from now", "operationId": "nfts-id-market-chart", "x-mint": { "href": "/reference/nfts-id-market-chart" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "NFT collection ID. \n*refers to [`/nfts/list`](/reference/nfts-list).", "schema": { "type": "string", "default": "pudgy-penguins" } }, { "name": "days", "in": "query", "required": true, "description": "Data up to number of days ago. \nValid values: any integer or `max`", "schema": { "type": "string", "default": "1" } } ], "responses": { "200": { "description": "NFT collection historical chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NFTMarketChart" }, "example": { "floor_price_usd": [ [ 1779729001000, 10032.419904380335 ], [ 1779729303000, 10028.703755252538 ] ], "floor_price_native": [ [ 1779729001000, 4.69989940999941 ], [ 1779729303000, 4.69989940999941 ] ], "h24_volume_usd": [ [ 1779729001000, 60835.49928667799 ], [ 1779729303000, 60812.96496397539 ] ], "h24_volume_native": [ [ 1779729001000, 28.49967703999703 ], [ 1779729303000, 28.49967703999703 ] ], "market_cap_usd": [ [ 1779729001000, 89168148.1101324 ], [ 1779729303000, 89135118.97668457 ] ], "market_cap_native": [ [ 1779729001000, 41772.70595607475 ], [ 1779729303000, 41772.70595607475 ] ] } } } } } } }, "/nfts/{asset_platform_id}/contract/{contract_address}/market_chart": { "get": { "summary": "NFTs Collection Historical Chart Data by Contract Address", "description": "To query historical market data of a NFT collection, including floor price, market cap, and 24hr volume, by number of days away from now based on the provided contract address", "operationId": "nfts-contract-address-market-chart", "x-mint": { "href": "/reference/nfts-contract-address-market-chart" }, "parameters": [ { "name": "asset_platform_id", "in": "path", "required": true, "description": "Asset platform ID. \n*refers to [`/asset_platforms`](/reference/asset-platforms-list).", "schema": { "type": "string", "default": "ethereum" } }, { "name": "contract_address", "in": "path", "required": true, "description": "Contract address of the NFT collection.", "schema": { "type": "string", "default": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8" } }, { "name": "days", "in": "query", "required": true, "description": "Data up to number of days ago. \nValid values: any integer or `max`", "schema": { "type": "string", "default": "1" } } ], "responses": { "200": { "description": "NFT collection historical chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NFTMarketChart" }, "example": { "floor_price_usd": [ [ 1779729001000, 10032.419904380335 ], [ 1779729303000, 10028.703755252538 ] ], "floor_price_native": [ [ 1779729001000, 4.69989940999941 ], [ 1779729303000, 4.69989940999941 ] ], "h24_volume_usd": [ [ 1779729001000, 60835.49928667799 ], [ 1779729303000, 60812.96496397539 ] ], "h24_volume_native": [ [ 1779729001000, 28.49967703999703 ], [ 1779729303000, 28.49967703999703 ] ], "market_cap_usd": [ [ 1779729001000, 89168148.1101324 ], [ 1779729303000, 89135118.97668457 ] ], "market_cap_native": [ [ 1779729001000, 41772.70595607475 ], [ 1779729303000, 41772.70595607475 ] ] } } } } } } }, "/nfts/{id}/tickers": { "get": { "summary": "NFTs Collection Tickers by ID", "description": "To query the latest floor price and 24hr volume of a NFT collection, on each NFT marketplace, e.g. OpenSea and Blur", "operationId": "nfts-id-tickers", "x-mint": { "href": "/reference/nfts-id-tickers" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "NFT collection ID. \n*refers to [`/nfts/list`](/reference/nfts-list).", "schema": { "type": "string", "default": "pudgy-penguins" } } ], "responses": { "200": { "description": "NFT collection tickers data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NFTTickers" }, "example": { "tickers": [ { "floor_price_in_native_currency": 5.57, "h24_volume_in_native_currency": 4.56, "native_currency": "ethereum", "native_currency_symbol": "ETH", "updated_at": "2026-05-26T17:00:49.982Z", "nft_marketplace_id": "opensea", "name": "OpenSea", "image": "https://coin-images.coingecko.com/nft_marketplaces/images/1/small/Opensea.png?1686193426", "nft_collection_url": "https://opensea.io/collection/pudgypenguins" }, { "floor_price_in_native_currency": 4.67, "h24_volume_in_native_currency": 28.12, "native_currency": "ethereum", "native_currency_symbol": "ETH", "updated_at": "2026-05-26T17:00:49.862Z", "nft_marketplace_id": "blur", "name": "Blur", "image": "https://coin-images.coingecko.com/nft_marketplaces/images/20/small/blur_logo.jpg?1690993708", "nft_collection_url": "https://blur.io/collection/pudgypenguins" } ] } } } } } } }, "/exchange_rates": { "get": { "summary": "BTC-to-Currency Exchange Rates", "description": "To query BTC exchange rates with other currencies", "operationId": "exchange-rates", "x-mint": { "href": "/reference/exchange-rates" }, "responses": { "200": { "description": "BTC exchange rates with other currencies", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExchangeRates" }, "example": { "rates": { "btc": { "name": "Bitcoin", "unit": "BTC", "value": 1.0, "type": "crypto" }, "eth": { "name": "Ether", "unit": "ETH", "value": 36.856, "type": "crypto" }, "ltc": { "name": "Litecoin", "unit": "LTC", "value": 1467.048, "type": "crypto" }, "bch": { "name": "Bitcoin Cash", "unit": "BCH", "value": 220.614, "type": "crypto" }, "bnb": { "name": "Binance Coin", "unit": "BNB", "value": 115.992, "type": "crypto" }, "eos": { "name": "EOS", "unit": "EOS", "value": 966946.841, "type": "crypto" }, "xrp": { "name": "XRP", "unit": "XRP", "value": 57106.503, "type": "crypto" }, "xlm": { "name": "Lumens", "unit": "XLM", "value": 516007.211, "type": "crypto" }, "link": { "name": "Chainlink", "unit": "LINK", "value": 8071.362, "type": "crypto" }, "dot": { "name": "Polkadot", "unit": "DOT", "value": 60793.71, "type": "crypto" }, "yfi": { "name": "Yearn.finance", "unit": "YFI", "value": 31.064, "type": "crypto" }, "sol": { "name": "Solana", "unit": "SOL", "value": 910.892, "type": "crypto" }, "usd": { "name": "US Dollar", "unit": "$", "value": 75817.765, "type": "fiat" }, "aed": { "name": "United Arab Emirates Dirham", "unit": "DH", "value": 278488.131, "type": "fiat" }, "ars": { "name": "Argentine Peso", "unit": "$", "value": 106789785.77, "type": "fiat" }, "aud": { "name": "Australian Dollar", "unit": "A$", "value": 105840.918, "type": "fiat" }, "bdt": { "name": "Bangladeshi Taka", "unit": "৳", "value": 9307822.089, "type": "fiat" }, "bhd": { "name": "Bahraini Dinar", "unit": "BD", "value": 28600.735, "type": "fiat" }, "bmd": { "name": "Bermudian Dollar", "unit": "$", "value": 75817.765, "type": "fiat" }, "brl": { "name": "Brazil Real", "unit": "R$", "value": 382288.415, "type": "fiat" }, "cad": { "name": "Canadian Dollar", "unit": "CA$", "value": 104717.981, "type": "fiat" }, "chf": { "name": "Swiss Franc", "unit": "Fr.", "value": 59575.401, "type": "fiat" }, "clp": { "name": "Chilean Peso", "unit": "CLP$", "value": 67941058.208, "type": "fiat" }, "cny": { "name": "Chinese Yuan", "unit": "¥", "value": 515083.156, "type": "fiat" }, "czk": { "name": "Czech Koruna", "unit": "Kč", "value": 1582693.892, "type": "fiat" }, "dkk": { "name": "Danish Krone", "unit": "kr.", "value": 487401.483, "type": "fiat" }, "eur": { "name": "Euro", "unit": "€", "value": 65223.37, "type": "fiat" }, "gbp": { "name": "British Pound Sterling", "unit": "£", "value": 56399.471, "type": "fiat" }, "gel": { "name": "Georgian Lari", "unit": "₾", "value": 201993.691, "type": "fiat" }, "hkd": { "name": "Hong Kong Dollar", "unit": "HK$", "value": 594140.994, "type": "fiat" }, "huf": { "name": "Hungarian Forint", "unit": "Ft", "value": 23216805.355, "type": "fiat" }, "idr": { "name": "Indonesian Rupiah", "unit": "Rp", "value": 1350406835.492, "type": "fiat" }, "ils": { "name": "Israeli New Shekel", "unit": "₪", "value": 215451.345, "type": "fiat" }, "inr": { "name": "Indian Rupee", "unit": "₹", "value": 7255573.761, "type": "fiat" }, "jpy": { "name": "Japanese Yen", "unit": "¥", "value": 12079021.102, "type": "fiat" }, "krw": { "name": "South Korean Won", "unit": "₩", "value": 114295300.075, "type": "fiat" }, "kwd": { "name": "Kuwaiti Dinar", "unit": "KD", "value": 23466.584, "type": "fiat" }, "lkr": { "name": "Sri Lankan Rupee", "unit": "Rs", "value": 24658404.204, "type": "fiat" }, "mmk": { "name": "Burmese Kyat", "unit": "K", "value": 159202903.032, "type": "fiat" }, "mxn": { "name": "Mexican Peso", "unit": "MX$", "value": 1312974.009, "type": "fiat" }, "myr": { "name": "Malaysian Ringgit", "unit": "RM", "value": 300716.004, "type": "fiat" }, "ngn": { "name": "Nigerian Naira", "unit": "₦", "value": 104085661.749, "type": "fiat" }, "nok": { "name": "Norwegian Krone", "unit": "kr", "value": 703191.355, "type": "fiat" }, "nzd": { "name": "New Zealand Dollar", "unit": "NZ$", "value": 129943.993, "type": "fiat" }, "php": { "name": "Philippine Peso", "unit": "₱", "value": 4669881.64, "type": "fiat" }, "pkr": { "name": "Pakistani Rupee", "unit": "₨", "value": 21107508.631, "type": "fiat" }, "pln": { "name": "Polish Zloty", "unit": "zł", "value": 276389.874, "type": "fiat" }, "rub": { "name": "Russian Ruble", "unit": "₽", "value": 5459045.262, "type": "fiat" }, "sar": { "name": "Saudi Riyal", "unit": "SR", "value": 283561.022, "type": "fiat" }, "sek": { "name": "Swedish Krona", "unit": "kr", "value": 706593.222, "type": "fiat" }, "sgd": { "name": "Singapore Dollar", "unit": "S$", "value": 96873.041, "type": "fiat" }, "thb": { "name": "Thai Baht", "unit": "฿", "value": 2477440.273, "type": "fiat" }, "try": { "name": "Turkish Lira", "unit": "₺", "value": 3480331.296, "type": "fiat" }, "twd": { "name": "New Taiwan Dollar", "unit": "NT$", "value": 2384248.866, "type": "fiat" }, "uah": { "name": "Ukrainian hryvnia", "unit": "₴", "value": 3356872.299, "type": "fiat" }, "vef": { "name": "Venezuelan bolívar fuerte", "unit": "Bs.F", "value": 7591.632, "type": "fiat" }, "vnd": { "name": "Vietnamese đồng", "unit": "₫", "value": 1997306794.202, "type": "fiat" }, "zar": { "name": "South African Rand", "unit": "R", "value": 1242588.207, "type": "fiat" }, "xdr": { "name": "IMF Special Drawing Rights", "unit": "XDR", "value": 53137.563, "type": "fiat" }, "xag": { "name": "Silver - Troy Ounce", "unit": "XAG", "value": 995.118, "type": "commodity" }, "xau": { "name": "Gold - Troy Ounce", "unit": "XAU", "value": 16.843, "type": "commodity" }, "bits": { "name": "Bits", "unit": "μBTC", "value": 1000000.0, "type": "crypto" }, "sats": { "name": "Satoshi", "unit": "sats", "value": 100000000.0, "type": "crypto" }, "cop": { "name": "Colombian Peso", "unit": "$", "value": 279126134.558, "type": "fiat" }, "kes": { "name": "Kenyan Shilling", "unit": "KSh", "value": 9815367.857, "type": "fiat" }, "ron": { "name": "Romanian Leu", "unit": "lei", "value": 341733.412, "type": "fiat" }, "dop": { "name": "Dominican Peso", "unit": "RD$", "value": 4460079.423, "type": "fiat" }, "crc": { "name": "Costa Rican Colón", "unit": "₡", "value": 34279241.577, "type": "fiat" }, "hnl": { "name": "Honduran Lempira", "unit": "L", "value": 2016966.507, "type": "fiat" }, "zmw": { "name": "Zambian Kwacha", "unit": "ZK", "value": 1419566.341, "type": "fiat" }, "svc": { "name": "Salvadoran Colón", "unit": "₡", "value": 663313.856, "type": "fiat" }, "bam": { "name": "Bosnia and Herzegovina Convertible Mark", "unit": "KM", "value": 127362.018, "type": "fiat" }, "pen": { "name": "Peruvian Sol", "unit": "S/", "value": 258167.906, "type": "fiat" }, "gtq": { "name": "Guatemalan Quetzal", "unit": "Q", "value": 578018.87, "type": "fiat" }, "lbp": { "name": "Lebanese Pound", "unit": "ل.ل", "value": 6790586630.179, "type": "fiat" }, "amd": { "name": "Armenian Dram", "unit": "֏", "value": 27881224.901, "type": "fiat" } } } } } } } } }, "/search/trending": { "get": { "summary": "Trending Search List", "description": "To query trending search coins, NFTs and categories on CoinGecko in the last 24 hours", "operationId": "trending-search", "x-mint": { "href": "/reference/trending-search" }, "parameters": [ { "name": "show_max", "in": "query", "required": false, "description": "Show max number of results available for the given type. \nAvailable values: `coins`, `nfts`, `categories` \ne.g. `coins` or `coins,nfts,categories`", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Trending search coins, NFTs and categories", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrendingSearch" }, "example": { "coins": [ { "item": { "id": "bonk", "coin_id": 28600, "name": "Bonk", "symbol": "BONK", "market_cap_rank": 103, "thumb": "https://coin-images.coingecko.com/coins/images/28600/standard/bonk.jpg?1696527587", "small": "https://coin-images.coingecko.com/coins/images/28600/small/bonk.jpg?1696527587", "large": "https://coin-images.coingecko.com/coins/images/28600/large/bonk.jpg?1696527587", "slug": "bonk", "price_btc": 7.821066970851871e-11, "score": 0, "data": { "price": 5.938674704566297e-06, "price_btc": "0.00000000007821066970851871", "price_change_percentage_24h": { "usd": -3.2712597351582655, "btc": -1.2567575303632434 }, "market_cap": "$521,967,819", "market_cap_btc": "6883.418982779206", "total_volume": "$31,701,707", "total_volume_btc": "417.50253280497", "sparkline": "https://www.coingecko.com/coins/28600/sparkline.svg", "content": null } } } ], "nfts": [ { "id": "beeple-everydays-the-2020-collection", "name": "BEEPLE: EVERYDAYS - THE 2020 COLLECTION", "symbol": "BEEPLE2", "thumb": "https://coin-images.coingecko.com/nft_contracts/images/1327/standard/beeple-everydays-the-2020-collection.jpg?1707287783", "nft_contract_id": 1327, "native_currency_symbol": "eth", "floor_price_in_native_currency": 6.98, "floor_price_24h_percentage_change": 8.231790820932737, "data": { "floor_price": "6.98 ETH", "floor_price_in_usd_24h_percentage_change": "8.231790820932737", "h24_volume": "6.10 ETH", "h24_average_sale_price": "6.10 ETH", "sparkline": "https://www.coingecko.com/nft/1327/sparkline.svg", "content": null } } ], "categories": [ { "id": 102120809, "name": "Base Native", "top_3_coins_images": [ "https://assets.coingecko.com/coins/images/40008/small/USR_LOGO.png?1725222638", "https://assets.coingecko.com/coins/images/13187/small/7739.png?1696512969", "https://assets.coingecko.com/coins/images/70556/small/elizaOS_token_logo_high_quality.png?1763494093" ], "market_cap_1h_change": 0.1591461077485745, "slug": "base-native", "coins_count": "573", "data": { "market_cap": 117316549202.14426, "market_cap_btc": 1545658.5276991604, "total_volume": 16971131961.734743, "total_volume_btc": 223596.5430262045, "market_cap_change_percentage_24h": { "usd": 0.14714515711689605, "btc": 1.5918443786835867 }, "sparkline": "https://www.coingecko.com/categories/102120809/sparkline.svg" } } ] } } } } } } }, "/news": { "get": { "summary": "Crypto News", "description": "To query the latest crypto news and guides on CoinGecko", "operationId": "news", "x-mint": { "href": "/reference/news" }, "parameters": [ { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1 \nValid values: 1...20", "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "required": false, "description": "Total results per page. \nDefault value: 10 \nValid values: 1...20", "schema": { "type": "integer" } }, { "name": "coin_id", "in": "query", "required": false, "description": "Filter news by coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string" } }, { "name": "language", "in": "query", "required": false, "description": "Filter news by language. \nDefault: `en`", "schema": { "type": "string", "enum": [ "en", "ru", "de", "pl", "es", "vi", "fr", "pt-br", "ar", "bg", "cs", "da", "el", "fi", "he", "hi", "hr", "hu", "id", "it", "ja", "ko", "lt", "nl", "no", "ro", "sk", "sl", "sv", "th", "tr", "uk", "zh", "zh-tw" ] } }, { "name": "type", "in": "query", "required": false, "description": "Filter news by type. \nDefault: `all` \nNote: `guides` filter is only applicable if `coin_id` is specified and valid.", "schema": { "type": "string", "enum": [ "all", "news", "guides" ] } } ], "responses": { "200": { "description": "List of latest crypto news", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/News" }, "example": [ { "title": "European Union debates limits on Big Tech access to cloud tenders", "url": "https://cryptobriefing.com/eu-big-tech-cloud-tender-limits/", "image": "https://assets.coingecko.com/articles/images/107301317/large/open-uri20260527-7-l3llje.?1779877857", "author": "Editorial Team", "posted_at": "2026-05-27T10:27:57Z", "type": "news", "source_name": "Crypto Briefing", "related_coin_ids": [ "could", "union-2" ] }, { "title": "Implied Volatility and IV Crush in Bitcoin Options Explained", "url": "https://www.coingecko.com/learn/implied-volatility-iv-crush-bitcoin-options", "image": "https://coin-images.coingecko.com/posts/images/102135679/large/Implied_Volatility_Options.png?1779696471", "author": "Hans Be", "posted_at": "2026-05-25T13:08:37Z", "type": "guide", "source_name": "CoinGecko", "related_coin_ids": [ "bitcoin", "ethereum" ] } ] } } } } } }, "/global": { "get": { "summary": "Crypto Global Market Data", "description": "To query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc", "operationId": "crypto-global", "x-mint": { "href": "/reference/crypto-global" }, "responses": { "200": { "description": "Cryptocurrency global market data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Global" }, "example": { "data": { "active_cryptocurrencies": 17397, "upcoming_icos": 0, "ongoing_icos": 49, "ended_icos": 3376, "markets": 1476, "total_market_cap": { "btc": 34570737.199462704, "eth": 1259418635.423994, "usd": 2621040321355.0405 }, "total_volume": { "btc": 1254779.1727158197, "eth": 45711847.69194817, "usd": 95133256404.37308 }, "market_cap_percentage": { "btc": 57.9539332566265, "eth": 9.58227145398409, "usdt": 7.223241338072757 }, "market_cap_change_percentage_24h_usd": -1.6081983639177684, "volume_change_percentage_24h_usd": 33.064521460740046, "updated_at": 1779878351 } } } } } } } }, "/global/decentralized_finance_defi": { "get": { "summary": "Global DeFi Market Data", "description": "To query top 100 cryptocurrency global decentralized finance (DeFi) data including DeFi market cap, trading volume", "operationId": "global-defi", "x-mint": { "href": "/reference/global-defi" }, "responses": { "200": { "description": "Global decentralized finance (DeFi) market data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GlobalDeFi" }, "example": { "data": { "defi_market_cap": "93264745839.10368680452390205264", "eth_market_cap": "250923489878.18163813287624277972", "defi_to_eth_ratio": "37.1685990356589832537094209337357070624927603988429231656080063710045566", "trading_volume_24h": "3779246981.777563895687957584391", "defi_dominance": "3.5568819863542411077651904276222133821656380942701140395041020219966392", "top_coin_name": "Lido Staked Ether", "top_coin_defi_dominance": 19.77898778734103 } } } } } } } }, "/global/market_cap_chart": { "get": { "summary": "Global Market Cap Chart Data", "description": "To query historical global market cap and volume data by number of days away from now", "operationId": "global-market-cap-chart", "x-mint": { "href": "/reference/global-market-cap-chart" }, "parameters": [ { "name": "days", "in": "query", "required": true, "description": "Data up to number of days ago.", "schema": { "type": "string", "default": "1", "enum": [ "1", "7", "14", "30", "90", "180", "365", "max" ] } }, { "name": "vs_currency", "in": "query", "required": false, "description": "Target currency of market cap. \nDefault: `usd` \n*refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Global market cap chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GlobalMarketCapChart" }, "example": { "market_cap_chart": { "market_cap": [ [ 1779796800798, 2655918998143.8896 ], [ 1779800404411, 2654923308819.0776 ] ], "volume": [ [ 1779796800798, 72758388801.76349 ], [ 1779800404411, 73764769476.6961 ] ] } } } } } } } }, "/onchain/networks/{network}/pools/{address}": { "get": { "summary": "Specific Pool Data by Pool Address", "description": "To query the specific pool based on the provided network and pool address", "operationId": "pool-address", "x-mint": { "href": "/reference/pool-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "address", "in": "path", "required": true, "description": "Pool address.", "schema": { "type": "string", "default": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`", "schema": { "type": "string" } }, { "name": "include_volume_breakdown", "in": "query", "required": false, "description": "Include volume breakdown. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "include_composition", "in": "query", "required": false, "description": "Include pool composition. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Specific pool data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PoolAddressData" }, "example": { "data": { "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "type": "pool", "attributes": { "base_token_price_usd": "2087.83402802406", "base_token_price_native_currency": "1.0", "base_token_balance": "21389.8183230254", "base_token_liquidity_usd": "44682614.543365459190858949279370927520536805", "quote_token_price_usd": "1.00238840383302", "quote_token_price_native_currency": "0.000480112806762164", "quote_token_balance": "54351838.715647", "quote_token_liquidity_usd": "54511610.488634398923096739735612698563218038285229066528", "base_token_price_quote_token": "2082.843835689", "quote_token_price_base_token": "0.0004801128068", "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "name": "WETH / USDC 0.05%", "pool_name": "WETH / USDC", "pool_fee_percentage": "0.05", "pool_created_at": "2021-12-29T12:35:14Z", "fdv_usd": "4706830691.85796", "market_cap_usd": "4714013620.15169", "price_change_percentage": { "m5": "0.001", "m15": "0.339", "m30": "0.197", "h1": "0.157", "h6": "0.651", "h24": "-1.403" }, "transactions": { "m5": { "buys": 13, "sells": 10, "buyers": 11, "sellers": 9 }, "m15": { "buys": 34, "sells": 40, "buyers": 20, "sellers": 26 }, "m30": { "buys": 61, "sells": 60, "buyers": 35, "sellers": 36 }, "h1": { "buys": 88, "sells": 119, "buyers": 52, "sellers": 75 }, "h6": { "buys": 473, "sells": 510, "buyers": 214, "sellers": 288 }, "h24": { "buys": 2443, "sells": 2402, "buyers": 876, "sellers": 998 } }, "volume_usd": { "m5": "716095.073293581", "m15": "4099160.04970219", "m30": "6269664.41220889", "h1": "7654944.73813995", "h6": "22795729.3374518", "h24": "126052349.380686" }, "net_buy_volume_usd": { "m5": "25349.579300599", "m15": "44021.13947472", "m30": "785680.21125136", "h1": "621530.32432932", "h6": "768429.1331717", "h24": "-4911114.3005293" }, "buy_volume_usd": { "m5": "370722.32629709", "m15": "2071590.59458845", "m30": "3527672.31173012", "h1": "4138237.53123463", "h6": "11782079.2353117", "h24": "60570617.5400784" }, "sell_volume_usd": { "m5": "345372.746996491", "m15": "2027569.45511373", "m30": "2741992.10047876", "h1": "3516707.20690531", "h6": "11013650.10214", "h24": "65481731.8406077" }, "reserve_in_usd": "99194225.032", "locked_liquidity_percentage": "0.0" }, "relationships": { "base_token": { "data": { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token" } }, "quote_token": { "data": { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token" } }, "dex": { "data": { "id": "uniswap_v3", "type": "dex" } } } }, "included": [ { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token", "attributes": { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "symbol": "WETH", "decimals": 18, "image_url": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332", "coingecko_coin_id": "weth" } }, { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token", "attributes": { "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "name": "USD Coin", "symbol": "USDC", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602", "coingecko_coin_id": "usd-coin" } }, { "id": "uniswap_v3", "type": "dex", "attributes": { "name": "Uniswap V3" } } ] } } } } } } }, "/onchain/networks/trending_pools": { "get": { "summary": "Trending Pools List", "description": "To query all the trending pools across all networks on GeckoTerminal", "operationId": "trending-pools-list", "x-mint": { "href": "/reference/trending-pools-list" }, "parameters": [ { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`, `network`", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "duration", "in": "query", "required": false, "description": "Duration to sort trending list by. \nDefault: `24h`", "schema": { "type": "string", "enum": [ "5m", "1h", "6h", "24h" ] } }, { "name": "include_gt_community_data", "in": "query", "required": false, "description": "Include GeckoTerminal community data (sentiment votes, suspicious reports). \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Trending pools across all networks", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pool" }, "example": { "data": [ { "id": "base_0xec33256bf1ded407a57fd3c1965e7556e42ac14db09bc4e6fef57d5e2eb0b0b9", "type": "pool", "attributes": { "base_token_price_usd": "0.0000738759066917531", "base_token_price_native_currency": "0.0000000363525310457453", "quote_token_price_usd": "2076.36", "quote_token_price_native_currency": "1.0", "base_token_price_quote_token": "0.00000003635253105", "quote_token_price_base_token": "27508400.9622774", "address": "0xec33256bf1ded407a57fd3c1965e7556e42ac14db09bc4e6fef57d5e2eb0b0b9", "name": "GITLAWB / WETH", "pool_created_at": "2026-03-11T02:00:07Z", "fdv_usd": "7378641.34604051", "market_cap_usd": "7387590.669", "price_change_percentage": { "m5": "-0.298", "m15": "-0.016", "m30": "-4.618", "h1": "-9.394", "h6": "-19.15", "h24": "-30.893" }, "transactions": { "m5": { "buys": 9, "sells": 1, "buyers": 9, "sellers": 1 }, "m15": { "buys": 28, "sells": 9, "buyers": 22, "sellers": 9 }, "m30": { "buys": 100, "sells": 42, "buyers": 76, "sellers": 37 }, "h1": { "buys": 187, "sells": 77, "buyers": 125, "sellers": 62 }, "h6": { "buys": 396, "sells": 206, "buyers": 237, "sellers": 159 }, "h24": { "buys": 1827, "sells": 1119, "buyers": 874, "sellers": 642 } }, "volume_usd": { "m5": "4903.1102054097", "m15": "10538.6429382093", "m30": "79639.1969896469", "h1": "144469.00760098", "h6": "361229.128078271", "h24": "2108583.76373177" }, "reserve_in_usd": "2471839.0983", "sentiment_vote_positive_percentage": 83.33333333333334, "sentiment_vote_negative_percentage": 16.666666666666664, "community_sus_report": 6 }, "relationships": { "base_token": { "data": { "id": "base_0x5f980dcfc4c0fa3911554cf5ab288ed0eb13dba3", "type": "token" } }, "quote_token": { "data": { "id": "base_0x4200000000000000000000000000000000000006", "type": "token" } }, "network": { "data": { "id": "base", "type": "network" } }, "dex": { "data": { "id": "uniswap-v4-base", "type": "dex" } } } } ], "included": [ { "id": "base_0x5f980dcfc4c0fa3911554cf5ab288ed0eb13dba3", "type": "token", "attributes": { "address": "0x5f980dcfc4c0fa3911554cf5ab288ed0eb13dba3", "name": "gitlawb", "symbol": "GITLAWB", "decimals": 18, "image_url": "https://coin-images.coingecko.com/coins/images/102172941/large/b16bfbf1-8384-43fc-9797-88fba91ddca5.png?1776736251", "coingecko_coin_id": "gitlawb" } }, { "id": "base_0x4200000000000000000000000000000000000006", "type": "token", "attributes": { "address": "0x4200000000000000000000000000000000000006", "name": "Wrapped Ether", "symbol": "WETH", "decimals": 18, "image_url": "https://coin-images.coingecko.com/coins/images/39810/large/weth.png?1724139790", "coingecko_coin_id": "l2-standard-bridged-weth-base" } }, { "id": "uniswap-v4-base", "type": "dex", "attributes": { "name": "Uniswap V4 (Base)" } }, { "id": "base", "type": "network", "attributes": { "name": "Base", "coingecko_asset_platform_id": "base" } } ] } } } } } } }, "/onchain/networks/{network}/trending_pools": { "get": { "summary": "Trending Pools by Network", "description": "To query the trending pools based on the provided network", "operationId": "trending-pools-network", "x-mint": { "href": "/reference/trending-pools-network" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "duration", "in": "query", "required": false, "description": "Duration to sort trending list by. \nDefault: `24h`", "schema": { "type": "string", "enum": [ "5m", "1h", "6h", "24h" ] } }, { "name": "include_gt_community_data", "in": "query", "required": false, "description": "Include GeckoTerminal community data (sentiment votes, suspicious reports). \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Trending pools on a network", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pool" }, "example": { "data": [ { "id": "eth_0x76a411f14a704099ba476ce8dffc288a53295218", "type": "pool", "attributes": { "base_token_price_usd": "0.000157869028295179", "base_token_price_native_currency": "0.000000076174152494787", "quote_token_price_usd": "2066.59098774463", "quote_token_price_native_currency": "1.0", "base_token_price_quote_token": "0.00000007617415249", "quote_token_price_base_token": "13127812.6142386", "address": "0x76a411f14a704099ba476ce8dffc288a53295218", "name": "ASTEROID / WETH", "pool_created_at": "2024-09-10T10:18:23Z", "fdv_usd": "66412125.220192", "market_cap_usd": "66413921.515527", "price_change_percentage": { "m5": "-0.355", "m15": "-0.228", "m30": "0.284", "h1": "-4.605", "h6": "-13.908", "h24": "-20.721" }, "transactions": { "m5": { "buys": 7, "sells": 4, "buyers": 7, "sellers": 4 }, "m15": { "buys": 24, "sells": 11, "buyers": 24, "sellers": 11 }, "m30": { "buys": 62, "sells": 40, "buyers": 54, "sellers": 34 }, "h1": { "buys": 218, "sells": 174, "buyers": 153, "sellers": 116 }, "h6": { "buys": 784, "sells": 520, "buyers": 422, "sellers": 344 }, "h24": { "buys": 3175, "sells": 2431, "buyers": 1290, "sellers": 1169 } }, "volume_usd": { "m5": "5610.858166059", "m15": "10926.8813342462", "m30": "92508.9175387338", "h1": "471159.035768368", "h6": "1738275.01961596", "h24": "7900631.31777918" }, "reserve_in_usd": "2471711.2255", "sentiment_vote_positive_percentage": 0, "sentiment_vote_negative_percentage": 0, "community_sus_report": 4 }, "relationships": { "base_token": { "data": { "id": "eth_0xf280b16ef293d8e534e370794ef26bf312694126", "type": "token" } }, "quote_token": { "data": { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token" } }, "dex": { "data": { "id": "uniswap_v2", "type": "dex" } } } } ], "included": [ { "id": "eth_0xf280b16ef293d8e534e370794ef26bf312694126", "type": "token", "attributes": { "address": "0xf280b16ef293d8e534e370794ef26bf312694126", "name": "Asteroid Shiba", "symbol": "ASTEROID", "decimals": 9, "image_url": "https://coin-images.coingecko.com/coins/images/50333/large/IMG_0728.jpeg?1727384521", "coingecko_coin_id": "asteroid-shiba" } }, { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token", "attributes": { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "symbol": "WETH", "decimals": 18, "image_url": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332", "coingecko_coin_id": "weth" } }, { "id": "uniswap_v2", "type": "dex", "attributes": { "name": "Uniswap V2" } } ] } } } } } } }, "/onchain/networks/{network}/pools": { "get": { "summary": "Top Pools by Network", "description": "To query all the top pools based on the provided network", "operationId": "top-pools-network", "x-mint": { "href": "/reference/top-pools-network" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "required": false, "description": "Sort the pools by field. \nDefault: `h24_tx_count_desc`", "schema": { "type": "string", "enum": [ "h24_tx_count_desc", "h24_volume_usd_desc" ] } }, { "name": "include_gt_community_data", "in": "query", "required": false, "description": "Include GeckoTerminal community data (sentiment votes, suspicious reports). \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Top pools on a network", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pool" }, "example": { "data": [ { "id": "eth_0xe0554a476a092703abdb3ef35c80e0d76d32939f", "type": "pool", "attributes": { "base_token_price_usd": "1.00416362400354", "base_token_price_native_currency": "0.000486360749106006", "quote_token_price_usd": "2062.64658353477", "quote_token_price_native_currency": "1.0", "base_token_price_quote_token": "0.0004863607491", "quote_token_price_base_token": "2056.086972146", "address": "0xe0554a476a092703abdb3ef35c80e0d76d32939f", "name": "USDC / WETH 0.01%", "pool_created_at": "2021-12-30T20:32:10Z", "fdv_usd": "52795390278.303", "market_cap_usd": "76649272425.414", "price_change_percentage": { "m5": "0.355", "m15": "0.217", "m30": "0.422", "h1": "-0.011", "h6": "0.521", "h24": "0.621" }, "transactions": { "m5": { "buys": 46, "sells": 47, "buyers": 29, "sellers": 37 }, "m15": { "buys": 125, "sells": 133, "buyers": 90, "sellers": 98 }, "m30": { "buys": 216, "sells": 208, "buyers": 148, "sellers": 139 }, "h1": { "buys": 429, "sells": 521, "buyers": 277, "sellers": 286 }, "h6": { "buys": 2174, "sells": 2154, "buyers": 1195, "sellers": 956 }, "h24": { "buys": 8688, "sells": 8756, "buyers": 3656, "sellers": 2830 } }, "volume_usd": { "m5": "295843.242851232", "m15": "610802.206180104", "m30": "1007505.50492217", "h1": "3248217.38569341", "h6": "12299601.042572", "h24": "39081025.0003669" }, "reserve_in_usd": "4558978.8435", "sentiment_vote_positive_percentage": 0, "sentiment_vote_negative_percentage": 0, "community_sus_report": 2 }, "relationships": { "base_token": { "data": { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token" } }, "quote_token": { "data": { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token" } }, "dex": { "data": { "id": "uniswap_v3", "type": "dex" } } } } ], "included": [ { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token", "attributes": { "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "name": "USD Coin", "symbol": "USDC", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602", "coingecko_coin_id": "usd-coin" } }, { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token", "attributes": { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "symbol": "WETH", "decimals": 18, "image_url": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332", "coingecko_coin_id": "weth" } }, { "id": "uniswap_v3", "type": "dex", "attributes": { "name": "Uniswap V3" } } ] } } } } } } }, "/onchain/networks/{network}/dexes/{dex}/pools": { "get": { "summary": "Top Pools by DEX", "description": "To query all the top pools based on the provided network and decentralized exchange (DEX)", "operationId": "top-pools-dex", "x-mint": { "href": "/reference/top-pools-dex" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "dex", "in": "path", "required": true, "description": "DEX ID. \n*refers to [`/onchain/networks/{network}/dexes`](/reference/dexes-list).", "schema": { "type": "string", "default": "sushiswap" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "required": false, "description": "Sort the pools by field. \nDefault: `h24_tx_count_desc`", "schema": { "type": "string", "enum": [ "h24_tx_count_desc", "h24_volume_usd_desc" ] } }, { "name": "include_gt_community_data", "in": "query", "required": false, "description": "Include GeckoTerminal community data (sentiment votes, suspicious reports). \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Top pools on a network's DEX", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pool" }, "example": { "data": [ { "id": "eth_0x6469b34a2a4723163c4902dbbdea728d20693c12", "type": "pool", "attributes": { "base_token_price_usd": "2.53037158380141", "base_token_price_native_currency": "0.00122586914090918", "quote_token_price_usd": "2062.57293793663", "quote_token_price_native_currency": "1.0", "base_token_price_quote_token": "0.001225869141", "quote_token_price_base_token": "815.74775531", "address": "0x6469b34a2a4723163c4902dbbdea728d20693c12", "name": "NEAR / WETH", "pool_created_at": "2021-10-11T01:52:05Z", "fdv_usd": "8774304.71122981", "market_cap_usd": "8774304.71122981", "price_change_percentage": { "m5": "0", "m15": "0", "m30": "0.049", "h1": "0.428", "h6": "-0.885", "h24": "-12.097" }, "transactions": { "m5": { "buys": 0, "sells": 0, "buyers": 0, "sellers": 0 }, "m15": { "buys": 0, "sells": 0, "buyers": 0, "sellers": 0 }, "m30": { "buys": 1, "sells": 2, "buyers": 1, "sellers": 2 }, "h1": { "buys": 6, "sells": 4, "buyers": 2, "sellers": 3 }, "h6": { "buys": 39, "sells": 37, "buyers": 24, "sellers": 16 }, "h24": { "buys": 172, "sells": 180, "buyers": 62, "sellers": 55 } }, "volume_usd": { "m5": "0.0", "m15": "0.0", "m30": "215.04729883", "h1": "572.0025141642", "h6": "7298.4165779336", "h24": "38207.6214949268" }, "reserve_in_usd": "54784.7204", "sentiment_vote_positive_percentage": 0, "sentiment_vote_negative_percentage": 0, "community_sus_report": 0 }, "relationships": { "base_token": { "data": { "id": "eth_0x85f17cf997934a597031b2e18a9ab6ebd4b9f6a4", "type": "token" } }, "quote_token": { "data": { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token" } }, "dex": { "data": { "id": "sushiswap", "type": "dex" } } } } ], "included": [ { "id": "eth_0x85f17cf997934a597031b2e18a9ab6ebd4b9f6a4", "type": "token", "attributes": { "address": "0x85f17cf997934a597031b2e18a9ab6ebd4b9f6a4", "name": "NEAR", "symbol": "NEAR", "decimals": 24, "image_url": "https://coin-images.coingecko.com/coins/images/71681/large/near.png?1768905174", "coingecko_coin_id": "rainbow-bridged-near-ethereum" } }, { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token", "attributes": { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "symbol": "WETH", "decimals": 18, "image_url": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332", "coingecko_coin_id": "weth" } }, { "id": "sushiswap", "type": "dex", "attributes": { "name": "SushiSwap" } } ] } } } } } } }, "/onchain/pools/megafilter": { "get": { "summary": "Megafilter for Pools", "description": "To query pools based on various filters across all networks on GeckoTerminal", "operationId": "pools-megafilter", "x-mint": { "href": "/reference/pools-megafilter" }, "parameters": [ { "name": "networks", "in": "query", "required": false, "description": "Filter pools by networks, comma-separated if more than one. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string" } }, { "name": "dexes", "in": "query", "required": false, "description": "Filter pools by DEXes, comma-separated if more than one. \n*refers to [`/onchain/networks/{network}/dexes`](/reference/dexes-list).", "schema": { "type": "string" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`, `network`", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "required": false, "description": "Sort the pools by field. \nDefault: `h6_trending`", "schema": { "type": "string", "enum": [ "m5_trending", "h1_trending", "h6_trending", "h24_trending", "h24_tx_count_desc", "h24_tx_count_asc", "h24_volume_usd_desc", "h24_volume_usd_asc", "m5_price_change_percentage_asc", "h1_price_change_percentage_asc", "h6_price_change_percentage_asc", "h24_price_change_percentage_asc", "m5_price_change_percentage_desc", "h1_price_change_percentage_desc", "h6_price_change_percentage_desc", "h24_price_change_percentage_desc", "fdv_usd_asc", "fdv_usd_desc", "reserve_in_usd_asc", "reserve_in_usd_desc", "price_asc", "price_desc", "pool_created_at_desc" ] } }, { "name": "fdv_usd_min", "in": "query", "required": false, "description": "Minimum fully diluted value in USD.", "schema": { "type": "number" } }, { "name": "fdv_usd_max", "in": "query", "required": false, "description": "Maximum fully diluted value in USD.", "schema": { "type": "number" } }, { "name": "reserve_in_usd_min", "in": "query", "required": false, "description": "Minimum reserve in USD.", "schema": { "type": "number" } }, { "name": "reserve_in_usd_max", "in": "query", "required": false, "description": "Maximum reserve in USD.", "schema": { "type": "number" } }, { "name": "h24_volume_usd_min", "in": "query", "required": false, "description": "Minimum 24hr volume in USD.", "schema": { "type": "number" } }, { "name": "h24_volume_usd_max", "in": "query", "required": false, "description": "Maximum 24hr volume in USD.", "schema": { "type": "number" } }, { "name": "pool_created_hour_min", "in": "query", "required": false, "description": "Minimum pool age in hours.", "schema": { "type": "number" } }, { "name": "pool_created_hour_max", "in": "query", "required": false, "description": "Maximum pool age in hours.", "schema": { "type": "number" } }, { "name": "tx_count_min", "in": "query", "required": false, "description": "Minimum transaction count.", "schema": { "type": "integer" } }, { "name": "tx_count_max", "in": "query", "required": false, "description": "Maximum transaction count.", "schema": { "type": "integer" } }, { "name": "tx_count_duration", "in": "query", "required": false, "description": "Duration for transaction count metric. \nDefault: `24h`", "schema": { "type": "string", "enum": [ "5m", "1h", "6h", "24h" ] } }, { "name": "buys_min", "in": "query", "required": false, "description": "Minimum number of buy transactions.", "schema": { "type": "integer" } }, { "name": "buys_max", "in": "query", "required": false, "description": "Maximum number of buy transactions.", "schema": { "type": "integer" } }, { "name": "buys_duration", "in": "query", "required": false, "description": "Duration for buy transactions metric. \nDefault: `24h`", "schema": { "type": "string", "enum": [ "5m", "1h", "6h", "24h" ] } }, { "name": "sells_min", "in": "query", "required": false, "description": "Minimum number of sell transactions.", "schema": { "type": "integer" } }, { "name": "sells_max", "in": "query", "required": false, "description": "Maximum number of sell transactions.", "schema": { "type": "integer" } }, { "name": "sells_duration", "in": "query", "required": false, "description": "Duration for sell transactions metric. \nDefault: `24h`", "schema": { "type": "string", "enum": [ "5m", "1h", "6h", "24h" ] } }, { "name": "price_change_percentage_min", "in": "query", "required": false, "description": "Minimum price change percentage.", "schema": { "type": "number" } }, { "name": "price_change_percentage_max", "in": "query", "required": false, "description": "Maximum price change percentage.", "schema": { "type": "number" } }, { "name": "price_change_percentage_duration", "in": "query", "required": false, "description": "Duration for price change percentage metric. \nDefault: `24h`", "schema": { "type": "string", "enum": [ "5m", "1h", "6h", "24h" ] } }, { "name": "buy_tax_percentage_min", "in": "query", "required": false, "description": "Minimum buy tax percentage.", "schema": { "type": "number" } }, { "name": "buy_tax_percentage_max", "in": "query", "required": false, "description": "Maximum buy tax percentage.", "schema": { "type": "number" } }, { "name": "sell_tax_percentage_min", "in": "query", "required": false, "description": "Minimum sell tax percentage.", "schema": { "type": "number" } }, { "name": "sell_tax_percentage_max", "in": "query", "required": false, "description": "Maximum sell tax percentage.", "schema": { "type": "number" } }, { "name": "checks", "in": "query", "required": false, "description": "Filter options for various checks, comma-separated if more than one. \nAvailable values: `no_honeypot`, `good_gt_score`, `on_coingecko`, `has_social`", "schema": { "type": "string" } }, { "name": "include_unknown_honeypot_tokens", "in": "query", "required": false, "description": "When `checks` includes `no_honeypot`, set to `true` to also include unknown honeypot tokens. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Filtered pools across all networks", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pool" }, "example": { "data": [ { "id": "base_0x3e97c5ec8c73e7d566aca606472141a9b9a8c1fa", "type": "pool", "attributes": { "base_token_price_usd": "0.05193801053", "base_token_price_native_currency": "0.000025326242378315592946540670776322410025776", "quote_token_price_usd": "0.776158829933404", "quote_token_price_native_currency": "0.000376082386826923", "base_token_price_quote_token": "0.06734227197", "quote_token_price_base_token": "14.8495138445", "address": "0x3e97c5ec8c73e7d566aca606472141a9b9a8c1fa", "name": "DEUS / VIRTUAL", "pool_created_at": "2026-05-27T13:04:51Z", "fdv_usd": "45464410.8007355", "market_cap_usd": "0.0", "price_change_percentage": { "m5": "-3.42", "m15": "-9.171", "m30": "4.444", "h1": "5.06", "h6": "28.62", "h24": "28.62" }, "transactions": { "m5": { "buys": 20, "sells": 10, "buyers": 16, "sellers": 9 }, "m15": { "buys": 71, "sells": 30, "buyers": 51, "sellers": 27 }, "m30": { "buys": 139, "sells": 63, "buyers": 88, "sellers": 50 }, "h1": { "buys": 288, "sells": 163, "buyers": 167, "sellers": 120 }, "h6": { "buys": 2719, "sells": 1502, "buyers": 974, "sellers": 709 }, "h24": { "buys": 2719, "sells": 1502, "buyers": 974, "sellers": 709 } }, "volume_usd": { "m5": "14594.3019415648", "m15": "67379.9374046351", "m30": "133544.558315085", "h1": "375498.056536124", "h6": "4631158.03685961", "h24": "4631158.03685961" }, "reserve_in_usd": "1257212.6821" }, "relationships": { "base_token": { "data": { "id": "base_0x940a319b75861014a220d9c6c144d108552b089b", "type": "token" } }, "quote_token": { "data": { "id": "base_0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b", "type": "token" } }, "network": { "data": { "id": "base", "type": "network" } }, "dex": { "data": { "id": "aerodrome-base", "type": "dex" } } } } ], "included": [ { "id": "base_0x940a319b75861014a220d9c6c144d108552b089b", "type": "token", "attributes": { "address": "0x940a319b75861014a220d9c6c144d108552b089b", "name": "DEUS Token", "symbol": "DEUS", "decimals": 18, "image_url": "https://coin-images.coingecko.com/coins/images/68133/large/Screenshot_2025-08-07_at_8.52.11%E2%80%AFPM.png?1754901254", "coingecko_coin_id": "xmaquina" } }, { "id": "base_0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b", "type": "token", "attributes": { "address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b", "name": "Virtual Protocol", "symbol": "VIRTUAL", "decimals": 18, "image_url": "https://coin-images.coingecko.com/coins/images/34057/large/LOGOMARK.png?1708356054", "coingecko_coin_id": "virtual-protocol" } }, { "id": "aerodrome-base", "type": "dex", "attributes": { "name": "Aerodrome (Base)" } }, { "id": "base", "type": "network", "attributes": { "name": "Base", "coingecko_asset_platform_id": "base" } } ] } } } } } } }, "/onchain/pools/trending_search": { "get": { "summary": "Trending Search Pools", "description": "To query all the trending search pools across all networks on GeckoTerminal", "operationId": "trending-search-pools", "x-mint": { "href": "/reference/trending-search-pools" }, "parameters": [ { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`, `network`", "schema": { "type": "string" } }, { "name": "pools", "in": "query", "required": false, "description": "Number of pools to return, maximum 10. \nDefault value: 4", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Trending search pools across all networks", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrendingSearchPools" }, "example": { "data": [ { "id": "solana_ojW3ZwJMh9J1K2QS7g4YvoMrBso6saH2s7fthijqyoh", "type": "pool", "attributes": { "trending_rank": 0, "address": "ojW3ZwJMh9J1K2QS7g4YvoMrBso6saH2s7fthijqyoh", "name": "CYPAW / SOL", "pool_created_at": "2026-05-26T12:22:03Z", "fdv_usd": "2521.4293653196", "market_cap_usd": null, "volume_usd": { "h24": "1283.0470400706" }, "reserve_in_usd": "3899.9791" }, "relationships": { "network": { "data": { "id": "solana", "type": "network" } }, "dex": { "data": { "id": "pumpswap", "type": "dex" } }, "base_token": { "data": { "id": "solana_JCMoQSqzxNGkQWr4bPK4AzAi7wbBJEJ71ex1qKAxpump", "type": "token" } }, "quote_token": { "data": { "id": "solana_So11111111111111111111111111111111111111112", "type": "token" } } } } ], "included": [ { "id": "solana_JCMoQSqzxNGkQWr4bPK4AzAi7wbBJEJ71ex1qKAxpump", "type": "token", "attributes": { "address": "JCMoQSqzxNGkQWr4bPK4AzAi7wbBJEJ71ex1qKAxpump", "name": "CyberPaws", "symbol": "CYPAW", "decimals": 6, "image_url": "https://assets.geckoterminal.com/q0m4wsxl5elcsvbwep1zflp1nbnf", "coingecko_coin_id": null } }, { "id": "solana_So11111111111111111111111111111111111111112", "type": "token", "attributes": { "address": "So11111111111111111111111111111111111111112", "name": "Wrapped SOL", "symbol": "SOL", "decimals": 9, "image_url": "https://coin-images.coingecko.com/coins/images/21629/large/solana.jpg?1696520989", "coingecko_coin_id": "wrapped-solana" } }, { "id": "pumpswap", "type": "dex", "attributes": { "name": "PumpSwap" } }, { "id": "solana", "type": "network", "attributes": { "name": "Solana", "coingecko_asset_platform_id": "solana" } } ] } } } } } } }, "/onchain/networks/{network}/tokens/{token_address}/pools": { "get": { "summary": "Top Pools by Token Address", "description": "To query top pools based on the provided token contract address on a network", "operationId": "top-pools-contract-address", "x-mint": { "href": "/reference/top-pools-contract-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "token_address", "in": "path", "required": true, "description": "Token contract address.", "schema": { "type": "string", "default": "0xdac17f958d2ee523a2206206994597c13d831ec7" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`", "schema": { "type": "string" } }, { "name": "include_inactive_source", "in": "query", "required": false, "description": "Include tokens from inactive pools using the most recent swap. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "required": false, "description": "Sort the pools by field. \nDefault: `h24_volume_usd_liquidity_desc`", "schema": { "type": "string", "enum": [ "h24_volume_usd_liquidity_desc", "h24_tx_count_desc", "h24_volume_usd_desc" ] } }, { "name": "include_gt_community_data", "in": "query", "required": false, "description": "Include GeckoTerminal community data (sentiment votes, suspicious reports). \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Top pools for a token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pool" }, "example": { "data": [ { "id": "eth_0x395f91b34aa34a477ce3bc6505639a821b286a62b1a164fc1887fa3a5ef713a5", "type": "pool", "attributes": { "base_token_price_usd": "1.0008763651", "base_token_price_native_currency": "0.000482317790072442", "quote_token_price_usd": "0.998449563724543", "quote_token_price_native_currency": "0.000481148325490986", "base_token_price_quote_token": "1.0024305698", "quote_token_price_base_token": "0.9975753236", "address": "0x395f91b34aa34a477ce3bc6505639a821b286a62b1a164fc1887fa3a5ef713a5", "name": "USDC / USDT", "pool_created_at": "2025-04-13T14:45:47Z", "token_price_usd": "0.998449563724543", "fdv_usd": "96921299344.3568", "market_cap_usd": "189288747230.058", "price_change_percentage": { "m5": "0", "m15": "-0.08", "m30": "-0.02", "h1": "-0.55", "h6": "0.23", "h24": "-0.21" }, "transactions": { "m5": { "buys": 1, "sells": 0, "buyers": 1, "sellers": 0 }, "m15": { "buys": 2, "sells": 13, "buyers": 2, "sellers": 12 }, "m30": { "buys": 16, "sells": 22, "buyers": 15, "sellers": 21 }, "h1": { "buys": 44, "sells": 50, "buyers": 41, "sellers": 46 }, "h6": { "buys": 306, "sells": 373, "buyers": 240, "sellers": 305 }, "h24": { "buys": 1062, "sells": 1217, "buyers": 677, "sellers": 803 } }, "volume_usd": { "m5": "100.4170370205", "m15": "44354.6645720277", "m30": "2972422.02951497", "h1": "6273480.14455755", "h6": "31080731.7699018", "h24": "65665560.4792908" }, "reserve_in_usd": "545933958.0815", "sentiment_vote_positive_percentage": 0, "sentiment_vote_negative_percentage": 0, "community_sus_report": 2 }, "relationships": { "base_token": { "data": { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token" } }, "quote_token": { "data": { "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "token" } }, "dex": { "data": { "id": "uniswap-v4-ethereum", "type": "dex" } } } } ], "included": [ { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token", "attributes": { "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "name": "USD Coin", "symbol": "USDC", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602", "coingecko_coin_id": "usd-coin" } }, { "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "token", "attributes": { "address": "0xdac17f958d2ee523a2206206994597c13d831ec7", "name": "Tether USD", "symbol": "USDT", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661", "coingecko_coin_id": "tether" } }, { "id": "uniswap-v4-ethereum", "type": "dex", "attributes": { "name": "Uniswap V4 (Ethereum)" } } ] } } } } } } }, "/onchain/networks/{network}/tokens/{address}": { "get": { "summary": "Token Data by Token Address", "description": "To query specific token data based on the provided token contract address on a network", "operationId": "token-data-contract-address", "x-mint": { "href": "/reference/token-data-contract-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "address", "in": "path", "required": true, "description": "Token contract address.", "schema": { "type": "string", "default": "0xdac17f958d2ee523a2206206994597c13d831ec7" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include.", "schema": { "type": "string", "enum": [ "top_pools" ] } }, { "name": "include_composition", "in": "query", "required": false, "description": "Include pool composition. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "include_inactive_source", "in": "query", "required": false, "description": "Include token data from inactive pools using the most recent swap. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Token data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenData" }, "example": { "data": { "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "token", "attributes": { "address": "0xdac17f958d2ee523a2206206994597c13d831ec7", "name": "Tether USD", "symbol": "USDT", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661", "coingecko_coin_id": "tether", "total_supply": "97071854588430319.0", "normalized_total_supply": "97071854588.4303", "price_usd": "0.9976477279", "fdv_usd": "96843463696.399", "total_reserve_in_usd": "2701052887.0071499413427031774184", "volume_usd": { "h24": "572433180.559528" }, "market_cap_usd": "189135294432.762", "last_trade_timestamp": "1779897731" }, "relationships": { "top_pools": { "data": [ { "id": "eth_0x395f91b34aa34a477ce3bc6505639a821b286a62b1a164fc1887fa3a5ef713a5", "type": "pool" } ] } } }, "included": [ { "id": "eth_0x395f91b34aa34a477ce3bc6505639a821b286a62b1a164fc1887fa3a5ef713a5", "type": "pool", "attributes": { "base_token_price_usd": "1.00076841159283", "base_token_price_native_currency": "0.000482652821375511", "quote_token_price_usd": "0.99764772791269", "quote_token_price_native_currency": "0.000481147771090756", "base_token_price_quote_token": "1.0031280417", "quote_token_price_base_token": "0.9968817124", "address": "0x395f91b34aa34a477ce3bc6505639a821b286a62b1a164fc1887fa3a5ef713a5", "name": "USDC / USDT", "pool_created_at": "2025-04-13T14:45:47Z", "token_price_usd": "0.99764772791269", "fdv_usd": "96843463696.399", "market_cap_usd": "189136733045.442", "price_change_percentage": { "m5": "0.74", "m15": "0.52", "m30": "0.41", "h1": "0.49", "h6": "0.73", "h24": "0.1" }, "transactions": { "m5": { "buys": 0, "sells": 6, "buyers": 0, "sellers": 6 }, "m15": { "buys": 11, "sells": 23, "buyers": 11, "sellers": 13 }, "m30": { "buys": 15, "sells": 41, "buyers": 15, "sellers": 28 }, "h1": { "buys": 53, "sells": 60, "buyers": 50, "sellers": 45 }, "h6": { "buys": 314, "sells": 393, "buyers": 247, "sellers": 311 }, "h24": { "buys": 1066, "sells": 1219, "buyers": 682, "sellers": 800 } }, "volume_usd": { "m5": "5390.4353119892", "m15": "73424.879752289", "m30": "2984135.66431702", "h1": "6251379.50994286", "h6": "31152723.862617", "h24": "64799943.9574331" }, "reserve_in_usd": "548688496.6398", "last_trade_timestamp": "1779897791" }, "relationships": { "base_token": { "data": { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token" } }, "quote_token": { "data": { "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "token" } }, "dex": { "data": { "id": "uniswap-v4-ethereum", "type": "dex" } } } } ] } } } } } } }, "/onchain/networks/{network}/tokens/multi/{addresses}": { "get": { "summary": "Tokens Data by Token Addresses", "description": "To query multiple tokens data based on the provided token contract addresses on a network", "operationId": "tokens-data-contract-addresses", "x-mint": { "href": "/reference/tokens-data-contract-addresses" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "solana" } }, { "name": "addresses", "in": "path", "required": true, "description": "Token contract address, comma-separated if more than one token contract address.", "schema": { "type": "string", "default": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN,2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include.", "schema": { "type": "string", "enum": [ "top_pools" ] } }, { "name": "include_composition", "in": "query", "required": false, "description": "Include pool composition. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "include_inactive_source", "in": "query", "required": false, "description": "Include tokens from inactive pools using the most recent swap. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Multiple tokens data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MultiTokenData" }, "example": { "data": [ { "id": "solana_6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN", "type": "token", "attributes": { "address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN", "name": "OFFICIAL TRUMP", "symbol": "TRUMP", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/53746/large/trump.png?1737171561", "coingecko_coin_id": "official-trump", "total_supply": "999999108407137.0", "normalized_total_supply": "999999108.407137", "price_usd": "2.0174050182", "fdv_usd": "2017403219.4789", "total_reserve_in_usd": "38853273.6350283264033294", "volume_usd": { "h24": "2099707.5067169" }, "market_cap_usd": "478960276.377951" }, "relationships": { "top_pools": { "data": [ { "id": "solana_9d9mb8kooFfaD3SctgZtkxQypkshx6ezhbKio89ixyy2", "type": "pool" } ] } } }, { "id": "solana_2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump", "type": "token", "attributes": { "address": "2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump", "name": "SORACAT", "symbol": "SORACAT", "decimals": 6, "image_url": "https://assets.geckoterminal.com/o6djbxjg7ne8k1swjpybmdvtu11s", "coingecko_coin_id": null, "total_supply": "1000000000000000.0", "normalized_total_supply": "1000000000.0", "price_usd": null, "fdv_usd": null, "total_reserve_in_usd": "5234.61248798976042147487629165", "volume_usd": { "h24": "0.0" }, "market_cap_usd": null, "launchpad_details": { "graduation_percentage": 2.16, "completed": false, "completed_at": null, "migrated_destination_pool_address": null } }, "relationships": { "top_pools": { "data": [] } } } ], "included": [ { "id": "solana_9d9mb8kooFfaD3SctgZtkxQypkshx6ezhbKio89ixyy2", "type": "pool", "attributes": { "base_token_price_usd": "2.01740501818281139006336492319318380811954562178395002842369476", "base_token_price_native_currency": "0.0239250580677484", "quote_token_price_usd": "0.999569304917712897234320781454435071561674967628724909109738", "quote_token_price_native_currency": "0.0118488106949705", "base_token_price_quote_token": "2.0191948951", "quote_token_price_base_token": "0.4952468939", "address": "9d9mb8kooFfaD3SctgZtkxQypkshx6ezhbKio89ixyy2", "name": "TRUMP / USDC", "pool_created_at": "2025-01-18T10:39:31Z", "fdv_usd": "2017403219.49608", "market_cap_usd": "478960276.377951", "price_change_percentage": { "m5": "0", "m15": "-0.065", "m30": "-0.321", "h1": "0.023", "h6": "0.217", "h24": "-0.584" }, "transactions": { "m5": { "buys": 0, "sells": 0, "buyers": 0, "sellers": 0 }, "m15": { "buys": 0, "sells": 2, "buyers": 0, "sellers": 2 }, "m30": { "buys": 4, "sells": 5, "buyers": 3, "sellers": 2 }, "h1": { "buys": 10, "sells": 22, "buyers": 6, "sellers": 7 }, "h6": { "buys": 61, "sells": 90, "buyers": 26, "sellers": 25 }, "h24": { "buys": 252, "sells": 327, "buyers": 64, "sellers": 60 } }, "volume_usd": { "m5": "0.0", "m15": "597.6697876563", "m30": "11191.1430985437", "h1": "22383.1305344185", "h6": "149655.009727483", "h24": "524824.856290105" }, "reserve_in_usd": "34848559.9613" }, "relationships": { "base_token": { "data": { "id": "solana_6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN", "type": "token" } }, "quote_token": { "data": { "id": "solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "type": "token" } }, "dex": { "data": { "id": "meteora", "type": "dex" } } } } ] } } } } } } }, "/onchain/networks/{network}/tokens/{address}/info": { "get": { "summary": "Token Info by Token Address", "description": "To query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network", "operationId": "token-info-contract-address", "x-mint": { "href": "/reference/token-info-contract-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "solana" } }, { "name": "address", "in": "path", "required": true, "description": "Token contract address.", "schema": { "type": "string", "default": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump" } } ], "responses": { "200": { "description": "Token info data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenInfo" }, "example": { "data": { "id": "solana_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump", "type": "token", "attributes": { "address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump", "name": "Pippin", "symbol": "pippin", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/51589/large/pippin_logo.png?1731570163", "image": { "thumb": "https://coin-images.coingecko.com/coins/images/51589/thumb/pippin_logo.png?1731570163", "small": "https://coin-images.coingecko.com/coins/images/51589/small/pippin_logo.png?1731570163", "large": "https://coin-images.coingecko.com/coins/images/51589/large/pippin_logo.png?1731570163" }, "coingecko_coin_id": "pippin", "websites": [ "https://pippin.love", "https://www.yohei.me" ], "discord_url": null, "farcaster_url": null, "zora_url": null, "telegram_handle": "ThePippinCo", "twitter_handle": "pippinlovesyou", "description": "Pippin is an SVG unicorn drawn using the latest LLM benchmarks on ChatGPT 4o. It is an autonomous AI agent on X.", "gt_score": 86.54440366972477, "gt_score_details": { "pool": 87.5, "transaction": 66.667, "creation": 100.0, "info": 100.0, "holders": 100.0 }, "gt_verified": true, "categories": [ "Pump Fun", "Ai Agents" ], "gt_category_ids": [ "pump-fun", "ai-agents" ], "holders": { "count": 47911, "distribution_percentage": { "top_10": "73.7977", "11_20": "8.7309", "21_40": "5.6147", "rest": "11.8567" }, "last_updated": "2026-05-27T17:41:13Z" }, "mint_authority": "no", "freeze_authority": "no", "is_honeypot": "unknown" } } } } } } } } }, "/onchain/networks/{network}/pools/{pool_address}/info": { "get": { "summary": "Pool Tokens Info by Pool Address", "description": "To query pool metadata (base and quote token details, image, socials, websites, description, contract address, etc.) based on a provided pool contract address on a network", "operationId": "pool-token-info-contract-address", "x-mint": { "href": "/reference/pool-token-info-contract-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "solana" } }, { "name": "pool_address", "in": "path", "required": true, "description": "Pool contract address.", "schema": { "type": "string", "default": "8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include.", "schema": { "type": "string", "enum": [ "pool" ] } } ], "responses": { "200": { "description": "Pool tokens info data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PoolTokensInfo" }, "example": { "data": [ { "id": "solana_So11111111111111111111111111111111111111112", "type": "token", "attributes": { "address": "So11111111111111111111111111111111111111112", "name": "Wrapped SOL", "symbol": "SOL", "decimals": 9, "image_url": "https://coin-images.coingecko.com/coins/images/21629/large/solana.jpg?1696520989", "coingecko_coin_id": "wrapped-solana", "gt_score": 88.9908256880734, "gt_verified": true, "mint_authority": "no", "freeze_authority": "no", "is_honeypot": "unknown" }, "relationships": { "pool": { "data": { "id": "solana_8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt", "type": "pool" } } } }, { "id": "solana_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump", "type": "token", "attributes": { "address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump", "name": "Pippin", "symbol": "pippin", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/51589/large/pippin_logo.png?1731570163", "coingecko_coin_id": "pippin", "gt_score": 86.54440366972477, "gt_verified": true, "mint_authority": "no", "freeze_authority": "no", "is_honeypot": "unknown" }, "relationships": { "pool": { "data": { "id": "solana_8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt", "type": "pool" } } } } ], "included": [ { "id": "solana_8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt", "type": "pool", "attributes": { "base_token_address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump", "quote_token_address": "So11111111111111111111111111111111111111112", "sentiment_vote_positive_percentage": 0, "sentiment_vote_negative_percentage": 0, "community_sus_report": 27 } } ] } } } } } } }, "/onchain/tokens/info_recently_updated": { "get": { "summary": "Most Recently Updated Tokens List", "description": "To query 100 most recently updated tokens info of a specific network or across all networks on GeckoTerminal", "operationId": "tokens-info-recent-updated", "x-mint": { "href": "/reference/tokens-info-recent-updated" }, "parameters": [ { "name": "include", "in": "query", "required": false, "description": "Attributes for related resources to include.", "schema": { "type": "string", "enum": [ "network" ] } }, { "name": "network", "in": "query", "required": false, "description": "Filter tokens by provided network. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Most recently updated tokens info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenInfoRecentlyUpdated" }, "example": { "data": [ { "id": "ton_EQDCSrwrZPe4ZW-OBU1vxxalRxDeozKl_mU9Onhj-amUwHD-", "type": "token", "attributes": { "address": "EQDCSrwrZPe4ZW-OBU1vxxalRxDeozKl_mU9Onhj-amUwHD-", "name": "abrdn Physical Platinum Shares xStock", "symbol": "PPLTx", "decimals": 9, "image_url": "https://coin-images.coingecko.com/coins/images/102171960/large/Ticker_PPLTx__Company_Name_Physical_Platinum_Shares_ETF__Size_64x64.png?1770653933", "coingecko_coin_id": "abrdn-physical-platinum-shares-xstock", "websites": [ "https://xstocks.fi" ], "discord_url": null, "farcaster_url": null, "zora_url": null, "telegram_handle": "xstocksfi", "twitter_handle": "xstocksfi", "description": "For too long, investing has come with barriers. Borders. Brokers. Limitations.", "gt_score": null, "metadata_updated_at": "2026-05-28T01:52:27Z" }, "relationships": { "network": { "data": { "id": "ton", "type": "network" } } } }, { "id": "solana_Xst6eFD4YT6sz9RLMysN9SyvaZWtraSdVJQGu5ZkAme", "type": "token", "attributes": { "address": "Xst6eFD4YT6sz9RLMysN9SyvaZWtraSdVJQGu5ZkAme", "name": "abrdn Physical Platinum Shares xStock", "symbol": "PPLTx", "decimals": 8, "image_url": "https://coin-images.coingecko.com/coins/images/102171960/large/Ticker_PPLTx__Company_Name_Physical_Platinum_Shares_ETF__Size_64x64.png?1770653933", "coingecko_coin_id": "abrdn-physical-platinum-shares-xstock", "websites": [ "https://xstocks.fi" ], "discord_url": null, "farcaster_url": null, "zora_url": null, "telegram_handle": "xstocksfi", "twitter_handle": "xstocksfi", "description": "For too long, investing has come with barriers. Borders. Brokers. Limitations.", "gt_score": null, "metadata_updated_at": "2026-05-28T01:52:27Z" }, "relationships": { "network": { "data": { "id": "solana", "type": "network" } } } } ], "included": [ { "id": "ton", "type": "network", "attributes": { "name": "TON", "coingecko_asset_platform_id": "the-open-network" } }, { "id": "solana", "type": "network", "attributes": { "name": "Solana", "coingecko_asset_platform_id": "solana" } } ] } } } } } } }, "/onchain/networks/{network_id}/tokens/{token_address}/top_traders": { "get": { "summary": "Top Token Traders by Token Address", "description": "To query top token traders based on the provided token contract address on a network", "operationId": "top-token-traders-token-address", "x-mint": { "href": "/reference/top-token-traders-token-address" }, "parameters": [ { "name": "network_id", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "solana" } }, { "name": "token_address", "in": "path", "required": true, "description": "Token contract address.", "schema": { "type": "string", "default": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump" } }, { "name": "traders", "in": "query", "required": false, "description": "Number of top token traders to return, any integer or `max`. \nDefault value: 10", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "description": "Sort the traders by field. \nDefault: `realized_pnl_usd_desc`", "schema": { "type": "string", "enum": [ "realized_pnl_usd_desc", "unrealized_pnl_usd_desc", "total_buy_usd_desc", "total_sell_usd_desc" ] } }, { "name": "include_address_label", "in": "query", "required": false, "description": "Include address label data. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Top token traders data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TopTokenTraders" }, "example": { "data": { "id": "solana_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump", "type": "top_trader", "attributes": { "traders": [ { "address": "9PHm2cYU8DhwBrbRsqqAjhW9uXVrNR1RaLsvo9oGVeaq", "name": null, "label": null, "type": null, "realized_pnl_usd": "31244842.94313992596882866680186718799091028666087696697895", "unrealized_pnl_usd": null, "token_balance": null, "average_buy_price_usd": "0.107742029472092394285546782411629689178068069842295415369698476220071093", "average_sell_price_usd": "0.185768700769238679578034408599493144222248390198249281897411569987021326", "total_buy_count": 52433, "total_sell_count": 110413, "total_buy_token_amount": "270927018.63336", "total_sell_token_amount": "325324285.088228", "total_buy_usd": "29190226.8263815983907078691029715903175106331012100198765", "total_sell_usd": "60435069.76952152435953653590483877830842091976208698685545", "explorer_url": "https://solscan.io/account/9PHm2cYU8DhwBrbRsqqAjhW9uXVrNR1RaLsvo9oGVeaq" }, { "address": "EmDewJpfQaxWqxthX1FUyBCCPNGt8Ac5ek4M4pnGTgxC", "name": null, "label": null, "type": null, "realized_pnl_usd": "15905876.28067880560869831706113433929706359106197218605713", "unrealized_pnl_usd": null, "token_balance": null, "average_buy_price_usd": "0.184253360370337436869211178097415145516564034725531545632817230594310635", "average_sell_price_usd": "0.453961635984295417495686933363702788250069562233497749126971620666784823", "total_buy_count": 17794, "total_sell_count": 83977, "total_buy_token_amount": "17256482.108901", "total_sell_token_amount": "42041969.15458", "total_buy_usd": "3179564.81673561651094979626153080521112057472898785000329", "total_sell_usd": "19085441.09741442211964811332266514450818416579096003606042", "explorer_url": "https://solscan.io/account/EmDewJpfQaxWqxthX1FUyBCCPNGt8Ac5ek4M4pnGTgxC" } ] } } } } } } } } }, "/onchain/networks/{network}/tokens/{address}/top_holders": { "get": { "summary": "Top Token Holders by Token Address", "description": "To query top token holders based on the provided token contract address on a network", "operationId": "top-token-holders-token-address", "x-mint": { "href": "/reference/top-token-holders-token-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "solana" } }, { "name": "address", "in": "path", "required": true, "description": "Token contract address.", "schema": { "type": "string", "default": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump" } }, { "name": "holders", "in": "query", "required": false, "description": "Number of top token holders to return, any integer or `max`. \nDefault value: 10", "schema": { "type": "string" } }, { "name": "include_pnl_details", "in": "query", "required": false, "description": "Include PnL details for token holders. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Top token holders data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TopTokenHolders" }, "example": { "data": { "id": "solana_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump", "type": "top_holder", "attributes": { "last_updated_at": "2026-05-28T03:21:51.545Z", "holders": [ { "rank": 1, "address": "u6PJ8DtQuPFnfmwHbGFULQ4u4EgjDiyYKjVEsynXq2w", "label": "Wallet 1", "amount": "310021323.445634", "percentage": "31.0041", "value": "6157733.22", "average_buy_price_usd": null, "total_buy_count": null, "total_sell_count": null, "unrealized_pnl_usd": null, "unrealized_pnl_percentage": null, "realized_pnl_usd": null, "realized_pnl_percentage": null, "explorer_url": "https://solscan.io/account/u6PJ8DtQuPFnfmwHbGFULQ4u4EgjDiyYKjVEsynXq2w" }, { "rank": 2, "address": "28RWPC6XPxSxUVjd27KiNRtcHVxKtd6cjms7eBcxiqdV", "label": null, "amount": "87536939.662678", "percentage": "8.7543", "value": "1738684.02", "average_buy_price_usd": null, "total_buy_count": null, "total_sell_count": null, "unrealized_pnl_usd": null, "unrealized_pnl_percentage": null, "realized_pnl_usd": null, "realized_pnl_percentage": null, "explorer_url": "https://solscan.io/account/28RWPC6XPxSxUVjd27KiNRtcHVxKtd6cjms7eBcxiqdV" } ] } } } } } } } } }, "/onchain/networks/{network}/tokens/{token_address}/holders_chart": { "get": { "summary": "Historical Token Holders Chart by Token Address", "description": "To get the historical token holders chart based on the provided token contract address on a network", "operationId": "token-holders-chart-token-address", "x-mint": { "href": "/reference/token-holders-chart-token-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "solana" } }, { "name": "token_address", "in": "path", "required": true, "description": "Token contract address.", "schema": { "type": "string", "default": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump" } }, { "name": "days", "in": "query", "required": false, "description": "Number of days to return the historical token holders chart. \nDefault value: 7", "schema": { "type": "string", "enum": [ "7", "30", "max" ] } } ], "responses": { "200": { "description": "Historical token holders chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenHoldersChart" }, "example": { "data": { "id": "1dc4b7d5-f0fc-431e-893b-91490652148e", "type": "token_holders_snapshot", "attributes": { "token_holders_list": [ [ "2026-04-28T00:00:00.000Z", 52790 ], [ "2026-04-29T00:00:00.000Z", 52865 ] ] } }, "meta": { "token": { "name": "Pippin", "symbol": "pippin", "coingecko_coin_id": "pippin", "address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump" } } } } } } } } }, "/onchain/networks/{network}/pools/{pool_address}/ohlcv/{timeframe}": { "get": { "summary": "Pool OHLCV Chart by Pool Address", "description": "To get the OHLCV chart (Open, High, Low, Close, Volume) of a pool based on the provided pool address on a network", "operationId": "pool-ohlcv-contract-address", "x-mint": { "href": "/reference/pool-ohlcv-contract-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "pool_address", "in": "path", "required": true, "description": "Pool contract address.", "schema": { "type": "string", "default": "0x06da0fd433c1a5d7a4faa01111c044910a184553" } }, { "name": "timeframe", "in": "path", "required": true, "description": "Timeframe of the OHLCV chart.", "schema": { "type": "string", "default": "day", "enum": [ "day", "hour", "minute", "second" ] } }, { "name": "aggregate", "in": "query", "required": false, "description": "Time period to aggregate each OHLCV. \nAvailable values (day): `1` \nAvailable values (hour): `1`, `4`, `12` \nAvailable values (minute): `1`, `5`, `15` \nAvailable values (second): `1`, `15`, `30` \nDefault value: 1", "schema": { "type": "string" } }, { "name": "before_timestamp", "in": "query", "required": false, "description": "Return OHLCV data before this timestamp (integer seconds since epoch).", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "description": "Number of OHLCV results to return, maximum 1000. \nDefault value: 100", "schema": { "type": "integer" } }, { "name": "currency", "in": "query", "required": false, "description": "Return OHLCV in USD or quote token. \nDefault: `usd`", "schema": { "type": "string", "enum": [ "usd", "token" ] } }, { "name": "token", "in": "query", "required": false, "description": "Return OHLCV for token, use this to invert the chart. \nAvailable values: `base`, `quote`, or token address. \nDefault: `base`", "schema": { "type": "string" } }, { "name": "include_empty_intervals", "in": "query", "required": false, "description": "Include empty intervals with no trade data. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Pool OHLCV chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OHLCV" }, "example": { "data": { "id": "c2728da2-1bc8-4b3a-94ca-6248a3c6e966", "type": "ohlcv_request_response", "attributes": { "ohlcv_list": [ [ 1779926400, 1.00208165944741, 1.00257871811779, 0.985925654401274, 1.00027690571219, 3481.679733097695 ], [ 1779840000, 0.996152188066521, 1.0040610548489, 0.996152188066521, 1.00208165944741, 11911.669491500581 ] ] } }, "meta": { "base": { "name": "Tether USD", "symbol": "USDT", "coingecko_coin_id": "tether", "address": "0xdac17f958d2ee523a2206206994597c13d831ec7" }, "quote": { "name": "Wrapped Ether", "symbol": "WETH", "coingecko_coin_id": "weth", "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" } } } } } } } } }, "/onchain/networks/{network}/tokens/{token_address}/ohlcv/{timeframe}": { "get": { "summary": "Token OHLCV Chart by Token Address", "description": "To get the OHLCV chart (Open, High, Low, Close, Volume) of a token based on the provided token address on a network", "operationId": "token-ohlcv-token-address", "x-mint": { "href": "/reference/token-ohlcv-token-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "solana" } }, { "name": "token_address", "in": "path", "required": true, "description": "Token contract address.", "schema": { "type": "string", "default": "So11111111111111111111111111111111111111112" } }, { "name": "timeframe", "in": "path", "required": true, "description": "Timeframe of the OHLCV chart.", "schema": { "type": "string", "default": "day", "enum": [ "day", "hour", "minute", "second" ] } }, { "name": "aggregate", "in": "query", "required": false, "description": "Time period to aggregate each OHLCV. \nAvailable values (day): `1` \nAvailable values (hour): `1`, `4`, `12` \nAvailable values (minute): `1`, `5`, `15` \nAvailable values (second): `1`, `15`, `30` \nDefault value: 1", "schema": { "type": "string" } }, { "name": "before_timestamp", "in": "query", "required": false, "description": "Return OHLCV data before this timestamp (integer seconds since epoch).", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "description": "Number of OHLCV results to return, maximum 1000. \nDefault value: 100", "schema": { "type": "integer" } }, { "name": "currency", "in": "query", "required": false, "description": "Return OHLCV in USD or quote token. \nDefault: `usd`", "schema": { "type": "string", "enum": [ "usd", "token" ] } }, { "name": "include_empty_intervals", "in": "query", "required": false, "description": "Include empty intervals with no trade data. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "include_inactive_source", "in": "query", "required": false, "description": "Include token data from inactive pools using the most recent swap. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Token OHLCV chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OHLCV" }, "example": { "data": { "id": "2dea0d2f-bf0f-4fa6-a934-db61d9375dbe", "type": "ohlcv_request_response", "attributes": { "ohlcv_list": [ [ 1779926400, 82.26780088646034, 83.8971583220568, 79.9616, 80.4112417847994, 31314919.221351475 ], [ 1779840000, 83.65257586508716, 84.8896434634975, 81.99, 82.26780088646034, 118334565.59596911 ] ] } }, "meta": { "base": { "name": "Wrapped SOL", "symbol": "SOL", "coingecko_coin_id": "wrapped-solana", "address": "So11111111111111111111111111111111111111112" }, "quote": { "name": "USD Coin", "symbol": "USDC", "coingecko_coin_id": "usd-coin", "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" } } } } } } } } }, "/onchain/networks/{network}/pools/{pool_address}/trades": { "get": { "summary": "Past 24 Hour Trades by Pool Address", "description": "To query the last 300 trades in the past 24 hours based on the provided pool address", "operationId": "pool-trades-contract-address", "x-mint": { "href": "/reference/pool-trades-contract-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "pool_address", "in": "path", "required": true, "description": "Pool contract address.", "schema": { "type": "string", "default": "0x06da0fd433c1a5d7a4faa01111c044910a184553" } }, { "name": "trade_volume_in_usd_greater_than", "in": "query", "required": false, "description": "Filter trades by trade volume in USD greater than this value. \nDefault value: 0", "schema": { "type": "number" } }, { "name": "token", "in": "query", "required": false, "description": "Return trades for token, use this to invert the chart. \nAvailable values: `base`, `quote`, or token address. \nDefault: `base`", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Last 300 trades in past 24 hours from a pool", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Trades" }, "example": { "data": [ { "id": "eth_25191329_0x90a746e28f4db27b2595b8ac55ef999914ed09453d5924b1424b2c050fd053c3_99_1779941075", "type": "trade", "attributes": { "block_number": 25191329, "tx_hash": "0x90a746e28f4db27b2595b8ac55ef999914ed09453d5924b1424b2c050fd053c3", "tx_from_address": "0x0b0d1579b739b1996d28c53c4ff11e2c541a1188", "from_token_amount": "0.106968578509495", "to_token_amount": "211.331589", "price_from_in_currency_token": "1.0", "price_to_in_currency_token": "0.000506164643987487", "price_from_in_usd": "1976.18881048696", "price_to_in_usd": "1.00027690571219", "block_timestamp": "2026-05-28T04:04:11Z", "kind": "buy", "volume_in_usd": "211.39010792416", "from_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7" } }, { "id": "eth_25191103_0x8c7d19881344e94e69f69f44a3910a32183652b84156537ec23313bfa01ff054_804_1779938350", "type": "trade", "attributes": { "block_number": 25191103, "tx_hash": "0x8c7d19881344e94e69f69f44a3910a32183652b84156537ec23313bfa01ff054", "tx_from_address": "0x39b9a705f5aa2fdf315bf5cc8ecd71dc821f45b1", "from_token_amount": "192.459164", "to_token_amount": "0.096413761161719", "price_from_in_currency_token": "0.000500956977874636", "price_to_in_currency_token": "1.0", "price_from_in_usd": "0.992388076121959", "price_to_in_usd": "1980.98463531194", "block_timestamp": "2026-05-28T03:18:47Z", "kind": "sell", "volume_in_usd": "190.994179494001", "from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7", "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" } } ] } } } } } } }, "/onchain/networks/{network}/tokens/{token_address}/trades": { "get": { "summary": "Past 24 Hour Trades by Token Address", "description": "To query the last 300 trades in the past 24 hours, across all pools, based on the provided token contract address on a network", "operationId": "token-trades-contract-address", "x-mint": { "href": "/reference/token-trades-contract-address" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "token_address", "in": "path", "required": true, "description": "Token contract address.", "schema": { "type": "string", "default": "0xdac17f958d2ee523a2206206994597c13d831ec7" } }, { "name": "trade_volume_in_usd_greater_than", "in": "query", "required": false, "description": "Filter trades by trade volume in USD greater than this value. \nDefault value: 0", "schema": { "type": "number" } } ], "responses": { "200": { "description": "Last 300 trades in past 24 hours from a token across all pools", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenTrades" }, "example": { "data": [ { "id": "eth_25191526_0xe9d83fd4f20bd9a4d262df47aaed68822d8312adc903623dc08f004d0db42c48_418_1779943449", "type": "trade", "attributes": { "pool_address": "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852", "pool_dex": "uniswap_v2", "block_number": 25191526, "tx_hash": "0xe9d83fd4f20bd9a4d262df47aaed68822d8312adc903623dc08f004d0db42c48", "tx_from_address": "0xabba7bef6dffba87d66e6c3d2d612b1a57df2303", "from_token_amount": "18.0", "to_token_amount": "0.00906223763828302", "price_from_in_currency_token": "0.000503457646571279", "price_to_in_currency_token": "1.0", "price_from_in_usd": "0.996563779970825", "price_to_in_usd": "1979.43915790687", "block_timestamp": "2026-05-28T04:43:59Z", "kind": "buy", "volume_in_usd": "17.9381480394748", "from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7", "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" } }, { "id": "eth_25191526_0x41533cb177c05e4b651a1bac8cfb9497a7d325275b668ba6d42d0a2dbf01c3bc_121_1779943444", "type": "trade", "attributes": { "pool_address": "0x54578b6f942aeb23b67a8cef24220651306b8e26", "pool_dex": "uniswap_v3", "block_number": 25191526, "tx_hash": "0x41533cb177c05e4b651a1bac8cfb9497a7d325275b668ba6d42d0a2dbf01c3bc", "tx_from_address": "0x930b88a592a045c428f3d99f7f3e5f95e3967508", "from_token_amount": "1267.21454522135", "to_token_amount": "116.882923", "price_from_in_currency_token": "0.0000464421678267092", "price_to_in_currency_token": "0.000503514021305036", "price_from_in_usd": "0.0919444428573566", "price_to_in_usd": "0.996837967006657", "block_timestamp": "2026-05-28T04:43:59Z", "kind": "sell", "volume_in_usd": "116.513335341116", "from_token_address": "0x9aab071b4129b083b01cb5a0cb513ce7eca26fa5", "to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7" } } ] } } } } } } }, "/onchain/categories": { "get": { "summary": "Categories List", "description": "To query all the supported categories on GeckoTerminal", "operationId": "categories-list", "x-mint": { "href": "/reference/categories-list" }, "parameters": [ { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "required": false, "description": "Sort the categories by field. \nDefault: `h6_volume_percentage_desc`", "schema": { "type": "string", "enum": [ "h1_volume_percentage_desc", "h6_volume_percentage_desc", "h12_volume_percentage_desc", "h24_tx_count_desc", "h24_volume_usd_desc", "fdv_usd_desc", "reserve_in_usd_desc" ] } } ], "responses": { "200": { "description": "List of supported categories", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OnchainCategoriesList" }, "example": { "data": [ { "id": "basedotmeme-launchpad", "type": "category", "attributes": { "name": "Basedotmeme Launchpad", "description": "Tokens launched from base.meme launchpad. (https://base.meme/)", "volume_change_percentage": { "h1": "-80.77", "h6": "132756.5", "h12": "12603.22", "h24": "5165.63" }, "reserve_in_usd": "25598.43", "fdv_usd": "79496.96", "h24_volume_usd": "622.05", "h24_tx_count": 7 } }, { "id": "ape", "type": "category", "attributes": { "name": "Ape", "description": "Tokens related to the great apes ", "volume_change_percentage": { "h1": "1527.94", "h6": "9972.78", "h12": "5575.81", "h24": "3266.85" }, "reserve_in_usd": "22471204.46", "fdv_usd": "16309303406314.87", "h24_volume_usd": "26749165.82", "h24_tx_count": 103967 } } ] } } } } } } }, "/onchain/categories/{category_id}/pools": { "get": { "summary": "Pools by Category ID", "description": "To query all the pools based on the provided category ID", "operationId": "pools-category", "x-mint": { "href": "/reference/pools-category" }, "parameters": [ { "name": "category_id", "in": "path", "required": true, "description": "Category ID.", "schema": { "type": "string", "default": "pump-fun" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`, `network`", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "required": false, "description": "Sort the pools by field. \nDefault: `pool_created_at_desc`", "schema": { "type": "string", "enum": [ "m5_trending", "h1_trending", "h6_trending", "h24_trending", "h24_tx_count_desc", "h24_volume_usd_desc", "pool_created_at_desc", "h24_price_change_percentage_desc" ] } } ], "responses": { "200": { "description": "Pools by category", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CategoriesPools" }, "example": { "data": [ { "id": "solana_DaZJ1A8ZqiSbSr7M5uFudafDUXLSNQX1zVpcyDhJZEzF", "type": "pool", "attributes": { "base_token_price_usd": "0.0000013253687934057798494580598374625617972585734733709883585887625", "base_token_price_native_currency": "0.0000000176094592913516", "quote_token_price_usd": "80.816693597538487283130171047763638910597932545", "quote_token_price_native_currency": "1.0", "base_token_price_quote_token": "0.00000001760945929", "quote_token_price_base_token": "56787660.7370405", "address": "DaZJ1A8ZqiSbSr7M5uFudafDUXLSNQX1zVpcyDhJZEzF", "name": "69 / SOL", "pool_created_at": "2026-05-28T04:58:01Z", "fdv_usd": "5325.9944", "market_cap_usd": null, "price_change_percentage": { "m5": "2.451", "m15": "2.451", "m30": "2.451", "h1": "2.451", "h6": "2.451", "h24": "2.451" }, "reserve_in_usd": "1123.21403520731", "h24_volume_usd": "4.1209741111", "h24_tx_count": 2 }, "relationships": { "base_token": { "data": { "id": "solana_27pLeUemQJmxYGxsxzUTEkvi2e9eMs2xkBNB85u4pump", "type": "token" } }, "quote_token": { "data": { "id": "solana_So11111111111111111111111111111111111111112", "type": "token" } }, "network": { "data": { "id": "solana", "type": "network" } }, "dex": { "data": { "id": "pump-fun", "type": "dex" } } } } ], "included": [ { "id": "solana_27pLeUemQJmxYGxsxzUTEkvi2e9eMs2xkBNB85u4pump", "type": "token", "attributes": { "address": "27pLeUemQJmxYGxsxzUTEkvi2e9eMs2xkBNB85u4pump", "name": "pupu69$", "symbol": "69", "decimals": 6, "image_url": "https://assets.geckoterminal.com/zhxpv93rywekjkckn59b3a3ghl1v", "coingecko_coin_id": null } }, { "id": "solana_So11111111111111111111111111111111111111112", "type": "token", "attributes": { "address": "So11111111111111111111111111111111111111112", "name": "Wrapped SOL", "symbol": "SOL", "decimals": 9, "image_url": "https://coin-images.coingecko.com/coins/images/21629/large/solana.jpg?1696520989", "coingecko_coin_id": "wrapped-solana" } }, { "id": "pump-fun", "type": "dex", "attributes": { "name": "Pump.fun" } }, { "id": "solana", "type": "network", "attributes": { "name": "Solana", "coingecko_asset_platform_id": "solana" } } ] } } } } } } }, "/onchain/networks/new_pools": { "get": { "summary": "New Pools List", "description": "To query all the latest pools across all networks on GeckoTerminal", "operationId": "latest-pools-list", "x-mint": { "href": "/reference/latest-pools-list" }, "parameters": [ { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`, `network`", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "include_gt_community_data", "in": "query", "required": false, "description": "Include GeckoTerminal community data (sentiment votes, suspicious reports). \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Latest pools across all networks", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pool" }, "example": { "data": [ { "id": "solana_6EiJDBoHqRA3m6FqYBphpGomspmFxtj4mawUKYMZtcVG", "type": "pool", "attributes": { "base_token_price_usd": "0.00000148440590295321912651916468624641639408545041453058498522449228", "base_token_price_native_currency": null, "quote_token_price_usd": "83.768359508641337467584153811084885016464255852", "quote_token_price_native_currency": null, "base_token_price_quote_token": null, "quote_token_price_base_token": null, "address": "6EiJDBoHqRA3m6FqYBphpGomspmFxtj4mawUKYMZtcVG", "name": "MadDonkey / SOL", "pool_created_at": "2026-05-27T14:58:17Z", "fdv_usd": "3847.309588", "market_cap_usd": null, "price_change_percentage": { "m5": "-18.046", "m15": "-18.046", "m30": "-18.046", "h1": "-18.046", "h6": "-18.046", "h24": "-18.046" }, "transactions": { "m5": { "buys": 1, "sells": 1, "buyers": 1, "sellers": 1 }, "m15": { "buys": 1, "sells": 1, "buyers": 1, "sellers": 1 }, "m30": { "buys": 1, "sells": 1, "buyers": 1, "sellers": 1 }, "h1": { "buys": 1, "sells": 1, "buyers": 1, "sellers": 1 }, "h6": { "buys": 1, "sells": 1, "buyers": 1, "sellers": 1 }, "h24": { "buys": 1, "sells": 1, "buyers": 1, "sellers": 1 } }, "volume_usd": { "m5": "6.7101798706", "m15": "6.7101798706", "m30": "6.7101798706", "h1": "6.7101798706", "h6": "6.7101798706", "h24": "6.7101798706" }, "reserve_in_usd": null, "sentiment_vote_positive_percentage": 0, "sentiment_vote_negative_percentage": 0, "community_sus_report": 0 }, "relationships": { "base_token": { "data": { "id": "solana_2R33cGC6WaP1j2wcvmkAvGjTeEy1N1hvwZtBykmypump", "type": "token" } }, "quote_token": { "data": { "id": "solana_So11111111111111111111111111111111111111112", "type": "token" } }, "network": { "data": { "id": "solana", "type": "network" } }, "dex": { "data": { "id": "pump-fun", "type": "dex" } } } } ], "included": [ { "id": "solana_2R33cGC6WaP1j2wcvmkAvGjTeEy1N1hvwZtBykmypump", "type": "token", "attributes": { "address": "2R33cGC6WaP1j2wcvmkAvGjTeEy1N1hvwZtBykmypump", "name": "Donkey", "symbol": "MadDonkey", "decimals": 6, "image_url": null, "coingecko_coin_id": null } }, { "id": "solana_So11111111111111111111111111111111111111112", "type": "token", "attributes": { "address": "So11111111111111111111111111111111111111112", "name": "Wrapped SOL", "symbol": "SOL", "decimals": 9, "image_url": "https://coin-images.coingecko.com/coins/images/21629/large/solana.jpg?1696520989", "coingecko_coin_id": "wrapped-solana" } }, { "id": "pump-fun", "type": "dex", "attributes": { "name": "Pump.fun" } } ] } } } } } } }, "/onchain/networks/{network}/new_pools": { "get": { "summary": "New Pools by Network", "description": "To query all the latest pools based on the provided network", "operationId": "latest-pools-network", "x-mint": { "href": "/reference/latest-pools-network" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } }, { "name": "include_gt_community_data", "in": "query", "required": false, "description": "Include GeckoTerminal community data (sentiment votes, suspicious reports). \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Latest pools on a network", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pool" }, "example": { "data": [ { "id": "eth_0x4b025567ef3e47e7c6f091ba2e224d250eaeedadfddcee292c5281f632fbea07", "type": "pool", "attributes": { "base_token_price_usd": "0.0000462785114387554", "base_token_price_native_currency": "0.0000000194777059991249", "quote_token_price_usd": "2064.36505232757", "quote_token_price_native_currency": "1.0", "base_token_price_quote_token": "0.000000019477706", "quote_token_price_base_token": "51340748.2403178", "address": "0x4b025567ef3e47e7c6f091ba2e224d250eaeedadfddcee292c5281f632fbea07", "name": "GOSLINGS / ETH 1%", "pool_created_at": "2026-05-27T15:05:59Z", "fdv_usd": "46060.39188", "market_cap_usd": null, "price_change_percentage": { "m5": "46.095", "m15": "46.095", "m30": "46.095", "h1": "46.095", "h6": "46.095", "h24": "46.095" }, "transactions": { "m5": { "buys": 5, "sells": 1, "buyers": 5, "sellers": 1 }, "m15": { "buys": 5, "sells": 1, "buyers": 5, "sellers": 1 }, "m30": { "buys": 5, "sells": 1, "buyers": 5, "sellers": 1 }, "h1": { "buys": 5, "sells": 1, "buyers": 5, "sellers": 1 }, "h6": { "buys": 5, "sells": 1, "buyers": 5, "sellers": 1 }, "h24": { "buys": 5, "sells": 1, "buyers": 5, "sellers": 1 } }, "volume_usd": { "m5": "1522.0126601069", "m15": "1522.0126601069", "m30": "1522.0126601069", "h1": "1522.0126601069", "h6": "1522.0126601069", "h24": "1522.0126601069" }, "reserve_in_usd": "-97.3671492356286", "sentiment_vote_positive_percentage": 0, "sentiment_vote_negative_percentage": 0, "community_sus_report": 0 }, "relationships": { "base_token": { "data": { "id": "eth_0xd4c24d1172813702439ab03b914a7c6e1c65b110", "type": "token" } }, "quote_token": { "data": { "id": "eth_0x0000000000000000000000000000000000000000", "type": "token" } }, "dex": { "data": { "id": "uniswap-v4-ethereum", "type": "dex" } } } } ], "included": [ { "id": "eth_0xd4c24d1172813702439ab03b914a7c6e1c65b110", "type": "token", "attributes": { "address": "0xd4c24d1172813702439ab03b914a7c6e1c65b110", "name": "Justice for Goslings", "symbol": "GOSLINGS", "decimals": 18, "image_url": null, "coingecko_coin_id": null } }, { "id": "eth_0x0000000000000000000000000000000000000000", "type": "token", "attributes": { "address": "0x0000000000000000000000000000000000000000", "name": "Ether", "symbol": "ETH", "decimals": 18, "image_url": null, "coingecko_coin_id": null } }, { "id": "uniswap-v4-ethereum", "type": "dex", "attributes": { "name": "Uniswap V4 (Ethereum)" } } ] } } } } } } }, "/onchain/networks/{network}/pools/multi/{addresses}": { "get": { "summary": "Multiple Pools Data by Pool Addresses", "description": "To query multiple pools based on the provided network and pool addresses", "operationId": "pools-addresses", "x-mint": { "href": "/reference/pools-addresses" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "addresses", "in": "path", "required": true, "description": "Pool contract address, comma-separated if more than one pool contract address.", "schema": { "type": "string", "default": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`", "schema": { "type": "string" } }, { "name": "include_volume_breakdown", "in": "query", "required": false, "description": "Include volume breakdown. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "include_composition", "in": "query", "required": false, "description": "Include pool composition. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Multiple pools data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MultiPoolAddressData" }, "example": { "data": [ { "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "type": "pool", "attributes": { "base_token_price_usd": "2087.84394126108", "base_token_price_native_currency": "1.0", "base_token_balance": "21341.2567581564", "base_token_liquidity_usd": "44581759.9202084558888866184853251251371757144338", "quote_token_price_usd": "1.00206113475649", "quote_token_price_native_currency": "0.000479959386437488", "quote_token_balance": "54447706.143913", "quote_token_liquidity_usd": "54591030.8544913961746207304067005997478464613757298294624", "base_token_price_quote_token": "2083.509622392", "quote_token_price_base_token": "0.0004799593864", "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "name": "WETH / USDC 0.05%", "pool_name": "WETH / USDC", "pool_fee_percentage": "0.05", "pool_created_at": "2021-12-29T12:35:14Z", "fdv_usd": "4706853532.94868", "market_cap_usd": "4714036496.09939", "price_change_percentage": { "m5": "0", "m15": "0.001", "m30": "0.339", "h1": "0.157", "h6": "0.64", "h24": "-1.403" }, "transactions": { "m5": { "buys": 6, "sells": 5, "buyers": 6, "sellers": 4 }, "m15": { "buys": 39, "sells": 16, "buyers": 29, "sellers": 12 }, "m30": { "buys": 75, "sells": 52, "buyers": 44, "sellers": 34 }, "h1": { "buys": 101, "sells": 108, "buyers": 63, "sellers": 64 }, "h6": { "buys": 486, "sells": 514, "buyers": 221, "sellers": 288 }, "h24": { "buys": 2447, "sells": 2405, "buyers": 878, "sellers": 1000 } }, "volume_usd": { "m5": "169302.729000635", "m15": "1135682.71288074", "m30": "5933192.37924989", "h1": "7342742.90980712", "h6": "23039712.0227694", "h24": "126282664.514509" }, "net_buy_volume_usd": { "m5": "-150936.4938119748", "m15": "124495.452251326", "m30": "1272049.71489431", "h1": "310733.1474086", "h6": "704731.2010502", "h24": "-4997173.0542116" }, "buy_volume_usd": { "m5": "9183.1175943302", "m15": "630089.082566032", "m30": "3602621.04707209", "h1": "3826738.02860785", "h6": "11872221.6119098", "h24": "60642745.7301488" }, "sell_volume_usd": { "m5": "160119.611406305", "m15": "505593.630314706", "m30": "2330571.33217778", "h1": "3516004.88119925", "h6": "11167490.4108596", "h24": "65639918.7843604" }, "reserve_in_usd": "99172790.7747", "locked_liquidity_percentage": "0.0" }, "relationships": { "base_token": { "data": { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token" } }, "quote_token": { "data": { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token" } }, "dex": { "data": { "id": "uniswap_v3", "type": "dex" } } } } ], "included": [ { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token", "attributes": { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "symbol": "WETH", "decimals": 18, "image_url": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332", "coingecko_coin_id": "weth" } }, { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token", "attributes": { "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "name": "USD Coin", "symbol": "USDC", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602", "coingecko_coin_id": "usd-coin" } }, { "id": "uniswap_v3", "type": "dex", "attributes": { "name": "Uniswap V3" } } ] } } } } } } }, "/onchain/search/pools": { "get": { "summary": "Search Pools & Tokens", "description": "To search for pools across all networks by pool address, token name, token symbol, or token contract address", "operationId": "search-pools", "x-mint": { "href": "/reference/search-pools" }, "parameters": [ { "name": "query", "in": "query", "required": false, "description": "Search query: pool contract address, token name, token symbol, or token contract address.", "schema": { "type": "string", "default": "weth" } }, { "name": "network", "in": "query", "required": false, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string" } }, { "name": "include", "in": "query", "required": false, "description": "Attributes to include, comma-separated if more than one. \nAvailable values: `base_token`, `quote_token`, `dex`", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Pool search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PoolSearch" }, "example": { "data": [ { "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "type": "pool", "attributes": { "base_token_price_usd": "2084.57214039429", "base_token_price_native_currency": "1.0", "quote_token_price_usd": "1.00359565004917", "quote_token_price_native_currency": "0.00048094599624371", "base_token_price_quote_token": "2079.235522928", "quote_token_price_base_token": "0.0004809459962", "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "name": "WETH / USDC 0.05%", "pool_created_at": "2021-12-29T12:35:14Z", "fdv_usd": "4700091001.66103", "market_cap_usd": "4706648770.97887", "price_change_percentage": { "m5": "0", "m15": "0", "m30": "0", "h1": "0", "h6": "0.599", "h24": "-1.887" }, "transactions": { "m5": { "buys": 1, "sells": 1, "buyers": 1, "sellers": 1 }, "m15": { "buys": 7, "sells": 24, "buyers": 7, "sellers": 18 }, "m30": { "buys": 21, "sells": 53, "buyers": 15, "sellers": 41 }, "h1": { "buys": 57, "sells": 123, "buyers": 39, "sellers": 88 }, "h6": { "buys": 431, "sells": 477, "buyers": 194, "sellers": 279 }, "h24": { "buys": 2436, "sells": 2385, "buyers": 863, "sellers": 989 } }, "volume_usd": { "m5": "2407.6289853096", "m15": "210244.509017768", "m30": "1067809.71712486", "h1": "2766027.68033409", "h6": "17336676.2757229", "h24": "122795216.58555" }, "reserve_in_usd": "101050763.5099" }, "relationships": { "base_token": { "data": { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token" } }, "quote_token": { "data": { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token" } }, "dex": { "data": { "id": "uniswap_v3", "type": "dex" } } } } ], "included": [ { "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "type": "token", "attributes": { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "symbol": "WETH", "decimals": 18, "image_url": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332", "coingecko_coin_id": "weth" } }, { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token", "attributes": { "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "name": "USD Coin", "symbol": "USDC", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602", "coingecko_coin_id": "usd-coin" } }, { "id": "uniswap_v3", "type": "dex", "attributes": { "name": "Uniswap V3" } } ] } } } } } } }, "/onchain/simple/networks/{network}/token_price/{addresses}": { "get": { "summary": "Token Price by Token Addresses", "description": "To get token price based on the provided token contract address on a network", "operationId": "onchain-simple-price", "x-mint": { "href": "/reference/onchain-simple-price" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "addresses", "in": "path", "required": true, "description": "Token contract address, comma-separated if more than one token contract address.", "schema": { "type": "string", "default": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" } }, { "name": "include_market_cap", "in": "query", "required": false, "description": "Include market capitalization. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "mcap_fdv_fallback", "in": "query", "required": false, "description": "Return FDV if market cap is not available. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "include_24hr_vol", "in": "query", "required": false, "description": "Include 24hr volume. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "include_24hr_price_change", "in": "query", "required": false, "description": "Include 24hr price change. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "include_total_reserve_in_usd", "in": "query", "required": false, "description": "Include total reserve in USD. \nDefault: `false`", "schema": { "type": "boolean" } }, { "name": "include_inactive_source", "in": "query", "required": false, "description": "Include token price data from inactive pools using the most recent swap. \nDefault: `false`", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Token price data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OnchainSimplePrice" }, "example": { "data": { "id": "49dd0b90-d99d-48b6-8fe2-03e826fbcef2", "type": "simple_token_price", "attributes": { "token_prices": { "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2084.57379936447" }, "market_cap_usd": { "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "4706652516.682727" }, "h24_volume_usd": { "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "313441016.145429" }, "h24_price_change_percentage": { "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "-1.8867250098940773" }, "total_reserve_in_usd": { "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1015673598.896450024556193850116628967" }, "last_trade_timestamp": { "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1779882383" } } } } } } } } } }, "/onchain/networks": { "get": { "summary": "Networks List", "description": "To retrieve a list of all supported networks on GeckoTerminal", "operationId": "networks-list", "x-mint": { "href": "/reference/networks-list" }, "parameters": [ { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of supported networks", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NetworksList" }, "example": { "data": [ { "id": "eth", "type": "network", "attributes": { "name": "Ethereum", "coingecko_asset_platform_id": "ethereum" } }, { "id": "bsc", "type": "network", "attributes": { "name": "BNB Chain", "coingecko_asset_platform_id": "binance-smart-chain" } } ] } } } } } } }, "/onchain/networks/{network}/dexes": { "get": { "summary": "DEXs List by Network", "description": "To query all the supported decentralized exchanges (DEXs) based on the provided network on GeckoTerminal", "operationId": "dexes-list", "x-mint": { "href": "/reference/dexes-list" }, "parameters": [ { "name": "network", "in": "path", "required": true, "description": "Network ID. \n*refers to [`/onchain/networks`](/reference/networks-list).", "schema": { "type": "string", "default": "eth" } }, { "name": "page", "in": "query", "required": false, "description": "Page through results. \nDefault value: 1", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of supported DEXs on a network", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DexesList" }, "example": { "data": [ { "id": "uniswap_v2", "type": "dex", "attributes": { "name": "Uniswap V2" } }, { "id": "sushiswap", "type": "dex", "attributes": { "name": "SushiSwap" } } ] } } } } } } } }, "components": { "securitySchemes": { "headerAuth": { "type": "apiKey", "in": "header", "name": "x-cg-pro-api-key" }, "queryAuth": { "type": "apiKey", "in": "query", "name": "x_cg_pro_api_key" } }, "schemas": { "PingServer": { "type": "object", "required": [ "gecko_says" ], "properties": { "gecko_says": { "type": "string", "description": "API server status message" } } }, "ApiUsage": { "type": "object", "required": [ "plan", "rate_limit_request_per_minute", "monthly_call_credit", "current_total_monthly_calls", "current_remaining_monthly_calls", "api_key_rate_limit_request_per_minute", "api_key_monthly_call_credit", "api_key_current_total_monthly_calls" ], "properties": { "plan": { "type": "string", "description": "Current subscription plan" }, "rate_limit_request_per_minute": { "type": "integer", "description": "Rate limit per minute for the plan" }, "monthly_call_credit": { "type": "integer", "description": "Total monthly API call credits for the plan" }, "current_total_monthly_calls": { "type": "integer", "description": "Total API calls made this month" }, "current_remaining_monthly_calls": { "type": "integer", "description": "Remaining API call credits this month" }, "api_key_rate_limit_request_per_minute": { "type": "integer", "description": "Rate limit per minute configured for this API key" }, "api_key_monthly_call_credit": { "type": "integer", "description": "Monthly call credit limit configured for this API key" }, "api_key_current_total_monthly_calls": { "type": "integer", "description": "Total API calls made this month by this API key" } } }, "TopGainersLosers": { "type": "object", "required": [ "top_gainers", "top_losers" ], "properties": { "top_gainers": { "type": "array", "items": { "$ref": "#/components/schemas/TopGainersLosersItem" } }, "top_losers": { "type": "array", "items": { "$ref": "#/components/schemas/TopGainersLosersItem" } } } }, "TopGainersLosersItem": { "type": "object", "required": [ "id", "symbol", "name", "image", "market_cap_rank", "usd", "usd_24h_vol", "usd_24h_change" ], "properties": { "id": { "type": "string", "description": "Coin ID" }, "symbol": { "type": "string", "description": "Coin symbol" }, "name": { "type": "string", "description": "Coin name" }, "image": { "type": "string", "description": "Coin image URL" }, "market_cap_rank": { "type": "integer", "nullable": true, "description": "Coin market cap rank" }, "usd": { "type": "number", "description": "Coin price in the target currency" }, "usd_24h_vol": { "type": "number", "description": "24-hour trading volume in the target currency" }, "usd_24h_change": { "type": "number", "nullable": true, "description": "24-hour price change percentage" }, "usd_1h_change": { "type": "number", "nullable": true, "description": "1-hour price change percentage" }, "usd_7d_change": { "type": "number", "nullable": true, "description": "7-day price change percentage" }, "usd_14d_change": { "type": "number", "nullable": true, "description": "14-day price change percentage" }, "usd_30d_change": { "type": "number", "nullable": true, "description": "30-day price change percentage" }, "usd_60d_change": { "type": "number", "nullable": true, "description": "60-day price change percentage" }, "usd_200d_change": { "type": "number", "nullable": true, "description": "200-day price change percentage" }, "usd_1y_change": { "type": "number", "nullable": true, "description": "1-year price change percentage" } } }, "CoinsIdTickers": { "type": "object", "required": [ "name", "tickers" ], "properties": { "name": { "type": "string", "description": "Coin name" }, "tickers": { "type": "array", "description": "List of tickers", "items": { "type": "object", "required": [ "base", "target", "market", "last", "volume", "converted_last", "converted_volume", "trust_score", "bid_ask_spread_percentage", "timestamp", "last_traded_at", "last_fetch_at", "is_anomaly", "is_stale", "trade_url", "token_info_url", "coin_id", "target_coin_id", "coin_mcap_usd" ], "properties": { "base": { "type": "string", "description": "Ticker base currency" }, "target": { "type": "string", "description": "Ticker target currency" }, "market": { "type": "object", "description": "Exchange information", "properties": { "name": { "type": "string", "description": "Exchange name" }, "identifier": { "type": "string", "description": "Exchange identifier" }, "has_trading_incentive": { "type": "boolean", "description": "Exchange trading incentive" }, "logo": { "type": "string", "description": "Exchange logo URL" } } }, "last": { "type": "number", "description": "Last price" }, "volume": { "type": "number", "description": "Trading volume" }, "cost_to_move_up_usd": { "type": "number", "description": "Cost to move price up by 2% in USD" }, "cost_to_move_down_usd": { "type": "number", "description": "Cost to move price down by 2% in USD" }, "converted_last": { "type": "object", "description": "Converted last price", "properties": { "btc": { "type": "number" }, "eth": { "type": "number" }, "usd": { "type": "number" } } }, "converted_volume": { "type": "object", "description": "Converted trading volume", "properties": { "btc": { "type": "number" }, "eth": { "type": "number" }, "usd": { "type": "number" } } }, "trust_score": { "type": "string", "nullable": true, "description": "Trust score" }, "bid_ask_spread_percentage": { "type": "number", "description": "Bid-ask spread percentage" }, "timestamp": { "type": "string", "description": "Ticker timestamp" }, "last_traded_at": { "type": "string", "description": "Last traded timestamp" }, "last_fetch_at": { "type": "string", "description": "Last fetch timestamp" }, "is_anomaly": { "type": "boolean", "description": "Whether ticker is anomalous" }, "is_stale": { "type": "boolean", "description": "Whether ticker is stale" }, "trade_url": { "type": "string", "description": "Trade URL" }, "token_info_url": { "type": "string", "nullable": true, "description": "Token info URL" }, "coin_id": { "type": "string", "description": "Base currency coin ID" }, "target_coin_id": { "type": "string", "description": "Target currency coin ID" }, "coin_mcap_usd": { "type": "number", "description": "Coin market cap in USD" } } } } } }, "CoinsIdHistory": { "type": "object", "required": [ "id", "symbol", "name", "image", "market_data", "community_data", "developer_data", "public_interest_stats" ], "properties": { "id": { "type": "string", "description": "Coin ID" }, "symbol": { "type": "string", "description": "Coin symbol" }, "name": { "type": "string", "description": "Coin name" }, "localization": { "type": "object", "description": "Localized coin names keyed by locale code", "additionalProperties": { "type": "string" } }, "image": { "type": "object", "description": "Coin image URLs", "properties": { "thumb": { "type": "string", "description": "Thumbnail image URL" }, "small": { "type": "string", "description": "Small image URL" } } }, "market_data": { "type": "object", "description": "Market data at the given date", "properties": { "current_price": { "type": "object", "description": "Current price keyed by currency", "additionalProperties": { "type": "number" } }, "market_cap": { "type": "object", "description": "Market capitalization keyed by currency", "additionalProperties": { "type": "number" } }, "total_volume": { "type": "object", "description": "Total trading volume keyed by currency", "additionalProperties": { "type": "number" } } } }, "community_data": { "type": "object", "description": "Community engagement data", "properties": { "facebook_likes": { "type": "number", "nullable": true, "description": "Number of Facebook likes" }, "reddit_average_posts_48h": { "type": "number", "description": "Average Reddit posts in 48 hours" }, "reddit_average_comments_48h": { "type": "number", "description": "Average Reddit comments in 48 hours" }, "reddit_subscribers": { "type": "number", "nullable": true, "description": "Number of Reddit subscribers" }, "reddit_accounts_active_48h": { "type": "number", "description": "Active Reddit accounts in 48 hours" } } }, "developer_data": { "type": "object", "description": "Developer activity data", "properties": { "forks": { "type": "number", "nullable": true, "description": "Repository forks" }, "stars": { "type": "number", "nullable": true, "description": "Repository stars" }, "subscribers": { "type": "number", "nullable": true, "description": "Repository subscribers" }, "total_issues": { "type": "number", "nullable": true, "description": "Total issues" }, "closed_issues": { "type": "number", "nullable": true, "description": "Closed issues" }, "pull_requests_merged": { "type": "number", "nullable": true, "description": "Pull requests merged" }, "pull_request_contributors": { "type": "number", "nullable": true, "description": "Pull request contributors" }, "code_additions_deletions_4_weeks": { "type": "object", "description": "Code additions and deletions in the last 4 weeks", "properties": { "additions": { "type": "number", "nullable": true, "description": "Lines added" }, "deletions": { "type": "number", "nullable": true, "description": "Lines deleted" } } }, "commit_count_4_weeks": { "type": "number", "nullable": true, "description": "Commit count in the last 4 weeks" } } }, "public_interest_stats": { "type": "object", "description": "Public interest statistics", "properties": { "alexa_rank": { "type": "number", "nullable": true, "description": "Alexa rank" }, "bing_matches": { "type": "number", "nullable": true, "description": "Bing search matches" } } } } }, "CoinsMarketChart": { "type": "object", "required": [ "prices", "market_caps", "total_volumes" ], "properties": { "prices": { "type": "array", "description": "Price data points as [timestamp, price] pairs", "items": { "type": "array", "items": { "type": "number" } } }, "market_caps": { "type": "array", "description": "Market cap data points as [timestamp, market_cap] pairs", "items": { "type": "array", "items": { "type": "number" } } }, "total_volumes": { "type": "array", "description": "Total volume data points as [timestamp, volume] pairs", "items": { "type": "array", "items": { "type": "number" } } } } }, "CoinsOHLC": { "type": "array", "description": "OHLC data points as [timestamp, open, high, low, close] arrays", "items": { "type": "array", "items": { "type": "number" } } }, "CirculatingSupplyChart": { "type": "object", "required": [ "circulating_supply" ], "properties": { "circulating_supply": { "type": "array", "description": "Circulating supply data points as [timestamp, supply] pairs", "items": { "type": "array", "items": { "oneOf": [ { "type": "number" }, { "type": "string" } ] } } } } }, "TotalSupplyChart": { "type": "object", "required": [ "total_supply" ], "properties": { "total_supply": { "type": "array", "description": "Total supply data points as [timestamp, supply] pairs", "items": { "type": "array", "items": { "oneOf": [ { "type": "number" }, { "type": "string" } ] } } } } }, "CoinsContractAddress": { "type": "object", "required": [ "id", "symbol", "name", "web_slug", "asset_platform_id", "platforms", "detail_platforms", "block_time_in_minutes", "hashing_algorithm", "categories", "preview_listing", "public_notice", "additional_notices", "description", "links", "image", "country_origin", "genesis_date", "contract_address", "sentiment_votes_up_percentage", "sentiment_votes_down_percentage", "watchlist_portfolio_users", "market_cap_rank", "market_cap_rank_with_rehypothecated", "status_updates", "last_updated" ], "properties": { "id": { "type": "string", "description": "Coin ID" }, "symbol": { "type": "string", "description": "Coin symbol" }, "name": { "type": "string", "description": "Coin name" }, "web_slug": { "type": "string", "description": "Coin web slug" }, "asset_platform_id": { "type": "string", "nullable": true, "description": "Coin asset platform ID" }, "platforms": { "type": "object", "description": "Coin asset platform and contract address", "additionalProperties": { "type": "string" } }, "detail_platforms": { "type": "object", "description": "Detailed coin asset platform and contract address", "additionalProperties": { "type": "object", "properties": { "decimal_place": { "type": "integer", "nullable": true, "description": "Token decimal place" }, "contract_address": { "type": "string", "description": "Token contract address" }, "geckoterminal_url": { "type": "string", "description": "GeckoTerminal URL" } } } }, "block_time_in_minutes": { "type": "number", "description": "Blockchain block time in minutes" }, "hashing_algorithm": { "type": "string", "nullable": true, "description": "Blockchain hashing algorithm" }, "categories": { "type": "array", "description": "Coin categories", "items": { "type": "string" } }, "preview_listing": { "type": "boolean", "description": "Preview listing coin" }, "public_notice": { "type": "string", "nullable": true, "description": "Public notice" }, "additional_notices": { "type": "array", "description": "Additional notices", "items": { "type": "string" } }, "localization": { "type": "object", "description": "Coin name localization", "additionalProperties": { "type": "string" } }, "description": { "type": "object", "description": "Coin description", "additionalProperties": { "type": "string" } }, "links": { "type": "object", "description": "Links", "properties": { "homepage": { "type": "array", "description": "Website URL", "items": { "type": "string" } }, "whitepaper": { "type": "string", "description": "Whitepaper URL" }, "blockchain_site": { "type": "array", "description": "Block explorer URL", "items": { "type": "string" } }, "official_forum_url": { "type": "array", "description": "Official forum URL", "items": { "type": "string" } }, "chat_url": { "type": "array", "description": "Chat URL", "items": { "type": "string" } }, "announcement_url": { "type": "array", "description": "Announcement URL", "items": { "type": "string" } }, "snapshot_url": { "type": "string", "nullable": true, "description": "Snapshot URL" }, "twitter_screen_name": { "type": "string", "description": "Twitter handle" }, "facebook_username": { "type": "string", "description": "Facebook username" }, "bitcointalk_thread_identifier": { "type": "integer", "nullable": true, "description": "Bitcointalk thread identifier" }, "telegram_channel_identifier": { "type": "string", "description": "Telegram channel identifier" }, "subreddit_url": { "type": "string", "description": "Subreddit URL" }, "repos_url": { "type": "object", "description": "Repository URL", "properties": { "github": { "type": "array", "description": "GitHub repository URL", "items": { "type": "string" } }, "bitbucket": { "type": "array", "description": "Bitbucket repository URL", "items": { "type": "string" } } } } } }, "image": { "type": "object", "description": "Coin image URL", "properties": { "thumb": { "type": "string" }, "small": { "type": "string" }, "large": { "type": "string" } } }, "country_origin": { "type": "string", "description": "Country of origin" }, "genesis_date": { "type": "string", "nullable": true, "description": "Genesis date" }, "contract_address": { "type": "string", "description": "Coin contract address" }, "sentiment_votes_up_percentage": { "type": "number", "nullable": true, "description": "Sentiment votes up percentage" }, "sentiment_votes_down_percentage": { "type": "number", "nullable": true, "description": "Sentiment votes down percentage" }, "watchlist_portfolio_users": { "type": "number", "description": "Number of users watching this coin in portfolio" }, "market_cap_rank": { "type": "integer", "nullable": true, "description": "Market cap rank" }, "market_cap_rank_with_rehypothecated": { "type": "integer", "nullable": true, "description": "Market cap rank including rehypothecated tokens" }, "market_data": { "type": "object", "description": "Market data", "properties": { "current_price": { "type": "object", "description": "Current price in target currency", "additionalProperties": { "type": "number" } }, "total_value_locked": { "type": "number", "nullable": true, "description": "Total value locked" }, "mcap_to_tvl_ratio": { "type": "number", "nullable": true, "description": "Market cap to TVL ratio" }, "fdv_to_tvl_ratio": { "type": "number", "nullable": true, "description": "FDV to TVL ratio" }, "roi": { "type": "object", "nullable": true, "description": "Return on investment", "properties": { "times": { "type": "number", "description": "ROI multiplier" }, "currency": { "type": "string", "description": "ROI currency" }, "percentage": { "type": "number", "description": "ROI percentage" } } }, "ath": { "type": "object", "description": "All-time high in target currency", "additionalProperties": { "type": "number" } }, "ath_change_percentage": { "type": "object", "description": "All-time high change percentage", "additionalProperties": { "type": "number" } }, "ath_date": { "type": "object", "description": "All-time high date", "additionalProperties": { "type": "string" } }, "atl": { "type": "object", "description": "All-time low in target currency", "additionalProperties": { "type": "number" } }, "atl_change_percentage": { "type": "object", "description": "All-time low change percentage", "additionalProperties": { "type": "number" } }, "atl_date": { "type": "object", "description": "All-time low date", "additionalProperties": { "type": "string" } }, "market_cap": { "type": "object", "description": "Market cap in target currency", "additionalProperties": { "type": "number" } }, "fully_diluted_valuation": { "type": "object", "description": "Fully diluted valuation in target currency", "additionalProperties": { "type": "number" } }, "market_cap_fdv_ratio": { "type": "number", "description": "Market cap to FDV ratio" }, "market_cap_rank": { "type": "integer", "nullable": true, "description": "Market cap rank" }, "outstanding_token_value_usd": { "type": "number", "nullable": true, "description": "Outstanding token value in USD" }, "market_cap_rank_with_rehypothecated": { "type": "integer", "nullable": true, "description": "Market cap rank including rehypothecated tokens" }, "total_volume": { "type": "object", "description": "Total trading volume in target currency", "additionalProperties": { "type": "number" } }, "high_24h": { "type": "object", "description": "24h price high in target currency", "additionalProperties": { "type": "number" } }, "low_24h": { "type": "object", "description": "24h price low in target currency", "additionalProperties": { "type": "number" } }, "price_change_24h": { "type": "number", "description": "24h price change in target currency" }, "price_change_percentage_24h": { "type": "number", "description": "24h price change percentage" }, "price_change_percentage_7d": { "type": "number", "description": "7d price change percentage" }, "price_change_percentage_14d": { "type": "number", "description": "14d price change percentage" }, "price_change_percentage_30d": { "type": "number", "description": "30d price change percentage" }, "price_change_percentage_60d": { "type": "number", "description": "60d price change percentage" }, "price_change_percentage_200d": { "type": "number", "description": "200d price change percentage" }, "price_change_percentage_1y": { "type": "number", "description": "1y price change percentage" }, "market_cap_change_24h": { "type": "number", "description": "24h market cap change in target currency" }, "market_cap_change_percentage_24h": { "type": "number", "description": "24h market cap change percentage" }, "price_change_24h_in_currency": { "type": "object", "description": "24h price change in target currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_1h_in_currency": { "type": "object", "description": "1h price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_24h_in_currency": { "type": "object", "description": "24h price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_7d_in_currency": { "type": "object", "description": "7d price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_14d_in_currency": { "type": "object", "description": "14d price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_30d_in_currency": { "type": "object", "description": "30d price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_60d_in_currency": { "type": "object", "description": "60d price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_200d_in_currency": { "type": "object", "description": "200d price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_1y_in_currency": { "type": "object", "description": "1y price change percentage per currency", "additionalProperties": { "type": "number" } }, "market_cap_change_24h_in_currency": { "type": "object", "description": "24h market cap change in target currency", "additionalProperties": { "type": "number" } }, "market_cap_change_percentage_24h_in_currency": { "type": "object", "description": "24h market cap change percentage per currency", "additionalProperties": { "type": "number" } }, "total_supply": { "type": "number", "description": "Total supply" }, "max_supply": { "type": "number", "nullable": true, "description": "Max supply" }, "max_supply_infinite": { "type": "boolean", "description": "Max supply infinite" }, "circulating_supply": { "type": "number", "description": "Circulating supply" }, "outstanding_supply": { "type": "number", "nullable": true, "description": "Tokens outstanding in the market" }, "last_updated": { "type": "string", "description": "Market data last updated timestamp" }, "sparkline_7d": { "type": "array", "description": "Sparkline 7-day price data", "items": { "type": "number" } } } }, "community_data": { "type": "object", "description": "Community data", "properties": { "facebook_likes": { "type": "number", "nullable": true, "description": "Facebook likes" }, "reddit_average_posts_48h": { "type": "number", "description": "Reddit average posts in 48 hours" }, "reddit_average_comments_48h": { "type": "number", "description": "Reddit average comments in 48 hours" }, "reddit_subscribers": { "type": "number", "description": "Reddit subscribers" }, "reddit_accounts_active_48h": { "type": "number", "description": "Reddit active accounts in 48 hours" }, "telegram_channel_user_count": { "type": "number", "nullable": true, "description": "Telegram channel user count" } } }, "developer_data": { "type": "object", "description": "Developer data", "properties": { "forks": { "type": "number", "description": "Repository forks" }, "stars": { "type": "number", "description": "Repository stars" }, "subscribers": { "type": "number", "description": "Repository subscribers" }, "total_issues": { "type": "number", "description": "Repository total issues" }, "closed_issues": { "type": "number", "description": "Repository closed issues" }, "pull_requests_merged": { "type": "number", "description": "Repository pull requests merged" }, "pull_request_contributors": { "type": "number", "description": "Repository pull request contributors" }, "code_additions_deletions_4_weeks": { "type": "object", "description": "Code additions and deletions in 4 weeks", "properties": { "additions": { "type": "number" }, "deletions": { "type": "number" } } }, "commit_count_4_weeks": { "type": "number", "description": "Repository commit count in 4 weeks" }, "last_4_weeks_commit_activity_series": { "type": "array", "description": "Repository last 4 weeks commit activity series", "items": { "type": "number" } } } }, "status_updates": { "type": "array", "description": "Status updates", "items": { "type": "object", "properties": { "description": { "type": "string", "description": "Status update description" }, "category": { "type": "string", "description": "Status update category" }, "created_at": { "type": "string", "description": "Status update creation time" }, "user": { "type": "string", "description": "Status update user" }, "user_title": { "type": "string", "description": "Status update user title" } } } }, "last_updated": { "type": "string", "description": "Last updated timestamp" }, "tickers": { "type": "array", "description": "Tickers", "items": { "type": "object", "properties": { "base": { "type": "string", "description": "Ticker base currency" }, "target": { "type": "string", "description": "Ticker target currency" }, "market": { "type": "object", "description": "Ticker exchange", "properties": { "name": { "type": "string", "description": "Exchange name" }, "identifier": { "type": "string", "description": "Exchange identifier" }, "has_trading_incentive": { "type": "boolean", "description": "Exchange trading incentive" } } }, "last": { "type": "number", "description": "Ticker last price" }, "volume": { "type": "number", "description": "Ticker volume" }, "converted_last": { "type": "object", "description": "Ticker converted last price", "properties": { "btc": { "type": "number" }, "eth": { "type": "number" }, "usd": { "type": "number" } } }, "converted_volume": { "type": "object", "description": "Ticker converted volume", "properties": { "btc": { "type": "number" }, "eth": { "type": "number" }, "usd": { "type": "number" } } }, "trust_score": { "type": "string", "nullable": true, "description": "Ticker trust score" }, "bid_ask_spread_percentage": { "type": "number", "description": "Ticker bid-ask spread percentage" }, "timestamp": { "type": "string", "description": "Ticker timestamp" }, "last_traded_at": { "type": "string", "description": "Ticker last traded timestamp" }, "last_fetch_at": { "type": "string", "description": "Ticker last fetch timestamp" }, "is_anomaly": { "type": "boolean", "description": "Ticker anomaly" }, "is_stale": { "type": "boolean", "description": "Ticker stale" }, "trade_url": { "type": "string", "description": "Ticker trade URL" }, "token_info_url": { "type": "string", "nullable": true, "description": "Ticker token info URL" }, "coin_id": { "type": "string", "description": "Ticker base currency coin ID" }, "target_coin_id": { "type": "string", "description": "Ticker target currency coin ID" }, "coin_mcap_usd": { "type": "number", "description": "Market cap in USD" } } } } } }, "CoinsID": { "type": "object", "required": [ "id", "symbol", "name", "web_slug", "asset_platform_id", "platforms", "detail_platforms", "block_time_in_minutes", "hashing_algorithm", "categories", "preview_listing", "public_notice", "additional_notices", "description", "links", "image", "country_origin", "genesis_date", "sentiment_votes_up_percentage", "sentiment_votes_down_percentage", "watchlist_portfolio_users", "market_cap_rank", "market_cap_rank_with_rehypothecated", "status_updates", "last_updated" ], "properties": { "id": { "type": "string", "description": "Coin ID" }, "symbol": { "type": "string", "description": "Coin symbol" }, "name": { "type": "string", "description": "Coin name" }, "web_slug": { "type": "string", "description": "Coin web slug" }, "asset_platform_id": { "type": "string", "nullable": true, "description": "Coin asset platform ID" }, "platforms": { "type": "object", "description": "Coin asset platform and contract address", "additionalProperties": { "type": "string" } }, "detail_platforms": { "type": "object", "description": "Detailed coin asset platform and contract address", "additionalProperties": { "type": "object", "properties": { "decimal_place": { "type": "integer", "nullable": true, "description": "Token decimal place" }, "contract_address": { "type": "string", "description": "Token contract address" } } } }, "block_time_in_minutes": { "type": "number", "description": "Blockchain block time in minutes" }, "hashing_algorithm": { "type": "string", "nullable": true, "description": "Blockchain hashing algorithm" }, "categories": { "type": "array", "description": "Coin categories", "items": { "type": "string" } }, "categories_details": { "type": "array", "description": "Detailed coin categories", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Category ID" }, "name": { "type": "string", "description": "Category name" } } } }, "preview_listing": { "type": "boolean", "description": "Preview listing coin" }, "public_notice": { "type": "string", "nullable": true, "description": "Public notice" }, "additional_notices": { "type": "array", "description": "Additional notices", "items": { "type": "string" } }, "localization": { "type": "object", "description": "Coin name localization", "additionalProperties": { "type": "string" } }, "description": { "type": "object", "description": "Coin description", "additionalProperties": { "type": "string" } }, "links": { "type": "object", "description": "Links", "properties": { "homepage": { "type": "array", "description": "Website URL", "items": { "type": "string" } }, "whitepaper": { "type": "string", "description": "Whitepaper URL" }, "blockchain_site": { "type": "array", "description": "Block explorer URL", "items": { "type": "string" } }, "official_forum_url": { "type": "array", "description": "Official forum URL", "items": { "type": "string" } }, "chat_url": { "type": "array", "description": "Chat URL", "items": { "type": "string" } }, "announcement_url": { "type": "array", "description": "Announcement URL", "items": { "type": "string" } }, "snapshot_url": { "type": "string", "nullable": true, "description": "Snapshot URL" }, "twitter_screen_name": { "type": "string", "description": "Twitter handle" }, "facebook_username": { "type": "string", "description": "Facebook username" }, "bitcointalk_thread_identifier": { "type": "integer", "nullable": true, "description": "Bitcointalk thread identifier" }, "telegram_channel_identifier": { "type": "string", "description": "Telegram channel identifier" }, "subreddit_url": { "type": "string", "description": "Subreddit URL" }, "repos_url": { "type": "object", "description": "Repository URL", "properties": { "github": { "type": "array", "description": "GitHub repository URL", "items": { "type": "string" } }, "bitbucket": { "type": "array", "description": "Bitbucket repository URL", "items": { "type": "string" } } } } } }, "image": { "type": "object", "description": "Coin image URL", "properties": { "thumb": { "type": "string" }, "small": { "type": "string" }, "large": { "type": "string" } } }, "country_origin": { "type": "string", "description": "Country of origin" }, "genesis_date": { "type": "string", "nullable": true, "description": "Genesis date" }, "sentiment_votes_up_percentage": { "type": "number", "nullable": true, "description": "Sentiment votes up percentage" }, "sentiment_votes_down_percentage": { "type": "number", "nullable": true, "description": "Sentiment votes down percentage" }, "ico_data": { "type": "object", "nullable": true, "description": "ICO data", "properties": { "ico_start_date": { "type": "string", "description": "ICO start date" }, "ico_end_date": { "type": "string", "description": "ICO end date" }, "short_desc": { "type": "string", "description": "Short description" }, "description": { "type": "string", "description": "Detailed description" }, "links": { "type": "object", "description": "ICO related links", "additionalProperties": { "type": "string" } }, "softcap_currency": { "type": "string", "description": "Softcap currency" }, "hardcap_currency": { "type": "string", "description": "Hardcap currency" }, "total_raised_currency": { "type": "string", "description": "Total raised currency" }, "softcap_amount": { "type": "number", "description": "Softcap amount" }, "hardcap_amount": { "type": "number", "description": "Hardcap amount" }, "total_raised": { "type": "number", "description": "Total raised amount" }, "quote_pre_sale_currency": { "type": "string", "description": "Quote pre-sale currency" }, "base_pre_sale_amount": { "type": "number", "description": "Base pre-sale amount" }, "quote_pre_sale_amount": { "type": "number", "description": "Quote pre-sale amount" }, "quote_public_sale_currency": { "type": "string", "description": "Quote public sale currency" }, "base_public_sale_amount": { "type": "number", "description": "Base public sale amount" }, "quote_public_sale_amount": { "type": "number", "description": "Quote public sale amount" }, "accepting_currencies": { "type": "string", "description": "Accepting currencies" }, "country_origin": { "type": "string", "description": "Country of origin" }, "pre_sale_start_date": { "type": "string", "description": "Pre-sale start date" }, "pre_sale_end_date": { "type": "string", "description": "Pre-sale end date" }, "whitelist_url": { "type": "string", "description": "Whitelist URL" }, "whitelist_start_date": { "type": "string", "description": "Whitelist start date" }, "whitelist_end_date": { "type": "string", "description": "Whitelist end date" }, "bounty_detail_url": { "type": "string", "description": "Bounty detail URL" }, "amount_for_sale": { "type": "number", "description": "Amount for sale" }, "kyc_required": { "type": "boolean", "description": "KYC required" }, "whitelist_available": { "type": "boolean", "description": "Whitelist available" }, "pre_sale_available": { "type": "boolean", "description": "Pre-sale available" }, "pre_sale_ended": { "type": "boolean", "description": "Pre-sale ended" } } }, "watchlist_portfolio_users": { "type": "number", "description": "Number of users watching this coin in portfolio" }, "market_cap_rank": { "type": "integer", "nullable": true, "description": "Market cap rank" }, "market_cap_rank_with_rehypothecated": { "type": "integer", "nullable": true, "description": "Market cap rank including rehypothecated tokens" }, "market_data": { "type": "object", "description": "Market data", "properties": { "current_price": { "type": "object", "description": "Current price in target currency", "additionalProperties": { "type": "number" } }, "total_value_locked": { "type": "number", "nullable": true, "description": "Total value locked" }, "mcap_to_tvl_ratio": { "type": "number", "nullable": true, "description": "Market cap to TVL ratio" }, "fdv_to_tvl_ratio": { "type": "number", "nullable": true, "description": "FDV to TVL ratio" }, "roi": { "type": "object", "nullable": true, "description": "Return on investment", "properties": { "times": { "type": "number", "description": "ROI multiplier" }, "currency": { "type": "string", "description": "ROI currency" }, "percentage": { "type": "number", "description": "ROI percentage" } } }, "ath": { "type": "object", "description": "All-time high in target currency", "additionalProperties": { "type": "number" } }, "ath_change_percentage": { "type": "object", "description": "All-time high change percentage", "additionalProperties": { "type": "number" } }, "ath_date": { "type": "object", "description": "All-time high date", "additionalProperties": { "type": "string" } }, "atl": { "type": "object", "description": "All-time low in target currency", "additionalProperties": { "type": "number" } }, "atl_change_percentage": { "type": "object", "description": "All-time low change percentage", "additionalProperties": { "type": "number" } }, "atl_date": { "type": "object", "description": "All-time low date", "additionalProperties": { "type": "string" } }, "market_cap": { "type": "object", "description": "Market cap in target currency", "additionalProperties": { "type": "number" } }, "fully_diluted_valuation": { "type": "object", "description": "Fully diluted valuation in target currency", "additionalProperties": { "type": "number" } }, "market_cap_fdv_ratio": { "type": "number", "description": "Market cap to FDV ratio" }, "market_cap_rank": { "type": "integer", "nullable": true, "description": "Market cap rank" }, "outstanding_token_value_usd": { "type": "number", "nullable": true, "description": "Outstanding token value in USD" }, "market_cap_rank_with_rehypothecated": { "type": "integer", "nullable": true, "description": "Market cap rank including rehypothecated tokens" }, "total_volume": { "type": "object", "description": "Total trading volume in target currency", "additionalProperties": { "type": "number" } }, "high_24h": { "type": "object", "description": "24h price high in target currency", "additionalProperties": { "type": "number" } }, "low_24h": { "type": "object", "description": "24h price low in target currency", "additionalProperties": { "type": "number" } }, "price_change_24h": { "type": "number", "description": "24h price change in target currency" }, "price_change_percentage_24h": { "type": "number", "description": "24h price change percentage" }, "price_change_percentage_7d": { "type": "number", "description": "7d price change percentage" }, "price_change_percentage_14d": { "type": "number", "description": "14d price change percentage" }, "price_change_percentage_30d": { "type": "number", "description": "30d price change percentage" }, "price_change_percentage_60d": { "type": "number", "description": "60d price change percentage" }, "price_change_percentage_200d": { "type": "number", "description": "200d price change percentage" }, "price_change_percentage_1y": { "type": "number", "description": "1y price change percentage" }, "market_cap_change_24h": { "type": "number", "description": "24h market cap change in target currency" }, "market_cap_change_percentage_24h": { "type": "number", "description": "24h market cap change percentage" }, "price_change_24h_in_currency": { "type": "object", "description": "24h price change in target currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_1h_in_currency": { "type": "object", "description": "1h price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_24h_in_currency": { "type": "object", "description": "24h price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_7d_in_currency": { "type": "object", "description": "7d price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_14d_in_currency": { "type": "object", "description": "14d price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_30d_in_currency": { "type": "object", "description": "30d price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_60d_in_currency": { "type": "object", "description": "60d price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_200d_in_currency": { "type": "object", "description": "200d price change percentage per currency", "additionalProperties": { "type": "number" } }, "price_change_percentage_1y_in_currency": { "type": "object", "description": "1y price change percentage per currency", "additionalProperties": { "type": "number" } }, "market_cap_change_24h_in_currency": { "type": "object", "description": "24h market cap change in target currency", "additionalProperties": { "type": "number" } }, "market_cap_change_percentage_24h_in_currency": { "type": "object", "description": "24h market cap change percentage per currency", "additionalProperties": { "type": "number" } }, "total_supply": { "type": "number", "description": "Total supply" }, "max_supply": { "type": "number", "nullable": true, "description": "Max supply" }, "max_supply_infinite": { "type": "boolean", "description": "Max supply infinite" }, "circulating_supply": { "type": "number", "description": "Circulating supply" }, "outstanding_supply": { "type": "number", "nullable": true, "description": "Tokens outstanding in the market" }, "last_updated": { "type": "string", "description": "Market data last updated timestamp" }, "sparkline_7d": { "type": "array", "description": "Sparkline 7-day price data", "items": { "type": "number" } } } }, "community_data": { "type": "object", "description": "Community data", "properties": { "facebook_likes": { "type": "number", "nullable": true, "description": "Facebook likes" }, "reddit_average_posts_48h": { "type": "number", "description": "Reddit average posts in 48 hours" }, "reddit_average_comments_48h": { "type": "number", "description": "Reddit average comments in 48 hours" }, "reddit_subscribers": { "type": "number", "description": "Reddit subscribers" }, "reddit_accounts_active_48h": { "type": "number", "description": "Reddit active accounts in 48 hours" }, "telegram_channel_user_count": { "type": "number", "nullable": true, "description": "Telegram channel user count" } } }, "developer_data": { "type": "object", "description": "Developer data", "properties": { "forks": { "type": "number", "description": "Repository forks" }, "stars": { "type": "number", "description": "Repository stars" }, "subscribers": { "type": "number", "description": "Repository subscribers" }, "total_issues": { "type": "number", "description": "Repository total issues" }, "closed_issues": { "type": "number", "description": "Repository closed issues" }, "pull_requests_merged": { "type": "number", "description": "Repository pull requests merged" }, "pull_request_contributors": { "type": "number", "description": "Repository pull request contributors" }, "code_additions_deletions_4_weeks": { "type": "object", "description": "Code additions and deletions in 4 weeks", "properties": { "additions": { "type": "number" }, "deletions": { "type": "number" } } }, "commit_count_4_weeks": { "type": "number", "description": "Repository commit count in 4 weeks" }, "last_4_weeks_commit_activity_series": { "type": "array", "description": "Repository last 4 weeks commit activity series", "items": { "type": "number" } } } }, "status_updates": { "type": "array", "description": "Status updates", "items": { "type": "object", "properties": { "description": { "type": "string", "description": "Status update description" }, "category": { "type": "string", "description": "Status update category" }, "created_at": { "type": "string", "description": "Status update creation time" }, "user": { "type": "string", "description": "Status update user" }, "user_title": { "type": "string", "description": "Status update user title" } } } }, "last_updated": { "type": "string", "description": "Last updated timestamp" }, "tickers": { "type": "array", "description": "Tickers", "items": { "type": "object", "properties": { "base": { "type": "string", "description": "Ticker base currency" }, "target": { "type": "string", "description": "Ticker target currency" }, "market": { "type": "object", "description": "Ticker exchange", "properties": { "name": { "type": "string", "description": "Exchange name" }, "identifier": { "type": "string", "description": "Exchange identifier" }, "has_trading_incentive": { "type": "boolean", "description": "Exchange trading incentive" } } }, "last": { "type": "number", "description": "Ticker last price" }, "volume": { "type": "number", "description": "Ticker volume" }, "converted_last": { "type": "object", "description": "Ticker converted last price", "properties": { "btc": { "type": "number" }, "eth": { "type": "number" }, "usd": { "type": "number" } } }, "converted_volume": { "type": "object", "description": "Ticker converted volume", "properties": { "btc": { "type": "number" }, "eth": { "type": "number" }, "usd": { "type": "number" } } }, "trust_score": { "type": "string", "nullable": true, "description": "Ticker trust score" }, "bid_ask_spread_percentage": { "type": "number", "description": "Ticker bid-ask spread percentage" }, "timestamp": { "type": "string", "description": "Ticker timestamp" }, "last_traded_at": { "type": "string", "description": "Ticker last traded timestamp" }, "last_fetch_at": { "type": "string", "description": "Ticker last fetch timestamp" }, "is_anomaly": { "type": "boolean", "description": "Ticker anomaly" }, "is_stale": { "type": "boolean", "description": "Ticker stale" }, "trade_url": { "type": "string", "description": "Ticker trade URL" }, "token_info_url": { "type": "string", "nullable": true, "description": "Ticker token info URL" }, "coin_id": { "type": "string", "description": "Ticker base currency coin ID" }, "target_coin_id": { "type": "string", "description": "Ticker target currency coin ID" }, "coin_mcap_usd": { "type": "number", "description": "Market cap in USD" } } } } } }, "CoinsMarkets": { "type": "array", "items": { "type": "object", "required": [ "id", "symbol", "name", "image", "current_price", "market_cap", "market_cap_rank", "fully_diluted_valuation", "total_volume", "high_24h", "low_24h", "price_change_24h", "price_change_percentage_24h", "market_cap_change_24h", "market_cap_change_percentage_24h", "circulating_supply", "total_supply", "max_supply", "ath", "ath_change_percentage", "ath_date", "atl", "atl_change_percentage", "atl_date", "roi", "last_updated" ], "properties": { "id": { "type": "string", "description": "Coin ID" }, "symbol": { "type": "string", "description": "Coin symbol" }, "name": { "type": "string", "description": "Coin name" }, "image": { "type": "string", "description": "Coin image URL" }, "current_price": { "type": "number", "nullable": true, "description": "Current price in target currency" }, "market_cap": { "type": "number", "nullable": true, "description": "Market cap in target currency" }, "market_cap_rank": { "type": "integer", "nullable": true, "description": "Market cap rank" }, "fully_diluted_valuation": { "type": "number", "nullable": true, "description": "Fully diluted valuation in target currency" }, "total_volume": { "type": "number", "nullable": true, "description": "Total trading volume in target currency" }, "high_24h": { "type": "number", "nullable": true, "description": "24-hour price high in target currency" }, "low_24h": { "type": "number", "nullable": true, "description": "24-hour price low in target currency" }, "price_change_24h": { "type": "number", "nullable": true, "description": "24-hour price change in target currency" }, "price_change_percentage_24h": { "type": "number", "nullable": true, "description": "24-hour price change percentage" }, "market_cap_change_24h": { "type": "number", "nullable": true, "description": "24-hour market cap change in target currency" }, "market_cap_change_percentage_24h": { "type": "number", "nullable": true, "description": "24-hour market cap change percentage" }, "circulating_supply": { "type": "number", "nullable": true, "description": "Circulating supply" }, "total_supply": { "type": "number", "nullable": true, "description": "Total supply" }, "max_supply": { "type": "number", "nullable": true, "description": "Max supply" }, "ath": { "type": "number", "nullable": true, "description": "All-time high price in target currency" }, "ath_change_percentage": { "type": "number", "nullable": true, "description": "All-time high change percentage" }, "ath_date": { "type": "string", "format": "date-time", "nullable": true, "description": "All-time high date" }, "atl": { "type": "number", "nullable": true, "description": "All-time low price in target currency" }, "atl_change_percentage": { "type": "number", "nullable": true, "description": "All-time low change percentage" }, "atl_date": { "type": "string", "format": "date-time", "nullable": true, "description": "All-time low date" }, "roi": { "type": "object", "nullable": true, "description": "Return on investment data", "properties": { "times": { "type": "number", "description": "ROI multiplier" }, "currency": { "type": "string", "description": "ROI currency" }, "percentage": { "type": "number", "description": "ROI percentage" } } }, "last_updated": { "type": "string", "format": "date-time", "description": "Last updated timestamp" }, "market_cap_rank_with_rehypothecated": { "type": "integer", "nullable": true, "description": "Market cap rank including rehypothecated tokens" }, "sparkline_in_7d": { "type": "object", "description": "Sparkline price data for the last 7 days", "properties": { "price": { "type": "array", "items": { "type": "number" }, "description": "Array of price values" } } }, "price_change_percentage_1h_in_currency": { "type": "number", "nullable": true, "description": "1-hour price change percentage in target currency" }, "price_change_percentage_24h_in_currency": { "type": "number", "nullable": true, "description": "24-hour price change percentage in target currency" }, "price_change_percentage_7d_in_currency": { "type": "number", "nullable": true, "description": "7-day price change percentage in target currency" }, "price_change_percentage_14d_in_currency": { "type": "number", "nullable": true, "description": "14-day price change percentage in target currency" }, "price_change_percentage_30d_in_currency": { "type": "number", "nullable": true, "description": "30-day price change percentage in target currency" }, "price_change_percentage_200d_in_currency": { "type": "number", "nullable": true, "description": "200-day price change percentage in target currency" }, "price_change_percentage_1y_in_currency": { "type": "number", "nullable": true, "description": "1-year price change percentage in target currency" } } } }, "CoinsListNew": { "type": "array", "items": { "type": "object", "required": [ "id", "symbol", "name", "activated_at" ], "properties": { "id": { "type": "string", "description": "Coin ID" }, "symbol": { "type": "string", "description": "Coin symbol" }, "name": { "type": "string", "description": "Coin name" }, "activated_at": { "type": "integer", "description": "Timestamp when coin was activated on CoinGecko" } } } }, "CoinsList": { "type": "array", "items": { "type": "object", "required": [ "id", "symbol", "name" ], "properties": { "id": { "type": "string", "description": "Coin ID" }, "symbol": { "type": "string", "description": "Coin symbol" }, "name": { "type": "string", "description": "Coin name" }, "platforms": { "type": "object", "description": "Asset platform and contract address", "additionalProperties": { "type": "string", "nullable": true } } } } }, "Search": { "type": "object", "required": [ "coins", "exchanges", "icos", "categories", "nfts" ], "properties": { "coins": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "api_symbol", "symbol", "market_cap_rank", "thumb", "large" ], "properties": { "id": { "type": "string", "description": "Coin ID" }, "name": { "type": "string", "description": "Coin name" }, "api_symbol": { "type": "string", "description": "Coin API symbol" }, "symbol": { "type": "string", "description": "Coin symbol" }, "market_cap_rank": { "type": "integer", "nullable": true, "description": "Coin market cap rank" }, "thumb": { "type": "string", "description": "Coin thumb image URL" }, "large": { "type": "string", "description": "Coin large image URL" } } } }, "exchanges": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "market_type", "thumb", "large" ], "properties": { "id": { "type": "string", "description": "Exchange ID" }, "name": { "type": "string", "description": "Exchange name" }, "market_type": { "type": "string", "description": "Exchange market type" }, "thumb": { "type": "string", "description": "Exchange thumb image URL" }, "large": { "type": "string", "description": "Exchange large image URL" } } } }, "icos": { "type": "array", "items": { "type": "object", "x-stainless-empty-object": true } }, "categories": { "type": "array", "items": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "string", "description": "Category ID" }, "name": { "type": "string", "description": "Category name" } } } }, "nfts": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "symbol", "thumb" ], "properties": { "id": { "type": "string", "description": "NFT collection ID" }, "name": { "type": "string", "description": "NFT collection name" }, "symbol": { "type": "string", "description": "NFT collection symbol" }, "thumb": { "type": "string", "description": "NFT collection thumb image URL" } } } } } }, "SupportedCurrencies": { "type": "array", "items": { "type": "string" } }, "SimplePrice": { "type": "object", "additionalProperties": { "type": "object", "properties": { "usd": { "type": "number", "description": "Price in the target currency" }, "usd_market_cap": { "type": "number", "description": "Market capitalization in the target currency" }, "usd_24h_vol": { "type": "number", "description": "24-hour trading volume in the target currency" }, "usd_24h_change": { "type": "number", "description": "24-hour price change percentage in the target currency" }, "last_updated_at": { "type": "number", "description": "Last updated timestamp in UNIX seconds" } } } }, "AssetPlatforms": { "type": "array", "items": { "type": "object", "required": [ "id", "chain_identifier", "name", "shortname", "native_coin_id", "image" ], "properties": { "id": { "type": "string", "description": "Asset platform ID" }, "chain_identifier": { "type": "number", "nullable": true, "description": "Chainlist's chain ID" }, "name": { "type": "string", "description": "Chain name" }, "shortname": { "type": "string", "description": "Chain shortname" }, "native_coin_id": { "type": "string", "nullable": true, "description": "Chain native coin ID" }, "image": { "type": "object", "description": "Asset platform image URLs", "properties": { "thumb": { "type": "string", "description": "Thumbnail image URL" }, "small": { "type": "string", "description": "Small image URL" }, "large": { "type": "string", "description": "Large image URL" } } } } } }, "TokenLists": { "type": "object", "required": [ "name", "logoURI", "keywords", "timestamp", "tokens", "version" ], "properties": { "name": { "type": "string", "description": "Token list name" }, "logoURI": { "type": "string", "description": "Token list logo URL" }, "keywords": { "type": "array", "description": "Token list keywords", "items": { "type": "string" } }, "timestamp": { "type": "string", "format": "date-time", "description": "Token list generation timestamp" }, "tokens": { "type": "array", "description": "List of tokens", "items": { "type": "object", "required": [ "chainId", "address", "name", "symbol", "decimals", "logoURI" ], "properties": { "chainId": { "type": "number", "description": "Chainlist's chain ID" }, "address": { "type": "string", "description": "Token contract address" }, "name": { "type": "string", "description": "Token name" }, "symbol": { "type": "string", "description": "Token symbol" }, "decimals": { "type": "number", "description": "Token decimals" }, "logoURI": { "type": "string", "description": "Token image URL" } } } }, "version": { "type": "object", "description": "Token list version", "properties": { "major": { "type": "number", "description": "Major version" }, "minor": { "type": "number", "description": "Minor version" }, "patch": { "type": "number", "description": "Patch version" } } } } }, "CategoriesList": { "type": "array", "items": { "type": "object", "required": [ "category_id", "name" ], "properties": { "category_id": { "type": "string", "description": "Category ID" }, "name": { "type": "string", "description": "Category name" } } } }, "Categories": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "market_cap", "market_cap_change_24h", "content", "top_3_coins_id", "top_3_coins", "volume_24h", "updated_at" ], "properties": { "id": { "type": "string", "description": "Category ID" }, "name": { "type": "string", "description": "Category name" }, "market_cap": { "type": "number", "description": "Category market cap" }, "market_cap_change_24h": { "type": "number", "description": "Category market cap change in 24 hours" }, "content": { "type": "string", "description": "Category description" }, "top_3_coins_id": { "type": "array", "description": "IDs of top 3 coins in the category", "items": { "type": "string" } }, "top_3_coins": { "type": "array", "description": "Image URLs of top 3 coins in the category", "items": { "type": "string" } }, "volume_24h": { "type": "number", "description": "Category trading volume in 24 hours" }, "updated_at": { "type": "string", "description": "Category last updated timestamp" } } } }, "Exchanges": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "year_established", "country", "description", "url", "image", "has_trading_incentive", "trust_score", "trust_score_rank", "trade_volume_24h_btc" ], "properties": { "id": { "type": "string", "description": "Exchange ID" }, "name": { "type": "string", "description": "Exchange name" }, "year_established": { "type": "number", "nullable": true, "description": "Year the exchange was established" }, "country": { "type": "string", "nullable": true, "description": "Country where the exchange is based" }, "description": { "type": "string", "description": "Exchange description" }, "url": { "type": "string", "description": "Exchange website URL" }, "image": { "type": "string", "description": "Exchange logo URL" }, "has_trading_incentive": { "type": "boolean", "description": "Whether the exchange has trading incentive" }, "trust_score": { "type": "number", "nullable": true, "description": "Exchange trust score" }, "trust_score_rank": { "type": "number", "nullable": true, "description": "Exchange trust score rank" }, "trade_volume_24h_btc": { "type": "number", "description": "Exchange 24h trading volume in BTC" } } } }, "ExchangesList": { "type": "array", "items": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "string", "description": "Exchange ID" }, "name": { "type": "string", "description": "Exchange name" } } } }, "ExchangesId": { "type": "object", "required": [ "name", "year_established", "country", "description", "url", "image", "facebook_url", "reddit_url", "telegram_url", "slack_url", "other_url_1", "other_url_2", "twitter_handle", "has_trading_incentive", "centralized", "public_notice", "alert_notice", "trust_score", "trust_score_rank", "coins", "pairs", "trade_volume_24h_btc", "tickers", "status_updates" ], "properties": { "name": { "type": "string", "description": "Exchange name" }, "year_established": { "type": "number", "nullable": true, "description": "Year the exchange was established" }, "country": { "type": "string", "nullable": true, "description": "Country where the exchange is based" }, "description": { "type": "string", "description": "Exchange description" }, "url": { "type": "string", "description": "Exchange website URL" }, "image": { "type": "string", "description": "Exchange logo URL" }, "facebook_url": { "type": "string", "description": "Facebook URL" }, "reddit_url": { "type": "string", "description": "Reddit URL" }, "telegram_url": { "type": "string", "description": "Telegram URL" }, "slack_url": { "type": "string", "description": "Slack URL" }, "other_url_1": { "type": "string", "description": "Other URL 1" }, "other_url_2": { "type": "string", "description": "Other URL 2" }, "twitter_handle": { "type": "string", "description": "Twitter handle" }, "has_trading_incentive": { "type": "boolean", "description": "Whether the exchange has trading incentive" }, "centralized": { "type": "boolean", "description": "Whether the exchange is centralized" }, "public_notice": { "type": "string", "description": "Public notice" }, "alert_notice": { "type": "string", "description": "Alert notice" }, "trust_score": { "type": "number", "nullable": true, "description": "Exchange trust score" }, "trust_score_rank": { "type": "number", "nullable": true, "description": "Exchange trust score rank" }, "coins": { "type": "number", "description": "Number of coins listed" }, "pairs": { "type": "number", "description": "Number of trading pairs" }, "trade_volume_24h_btc": { "type": "number", "description": "Exchange 24h trading volume in BTC" }, "tickers": { "type": "array", "description": "Exchange tickers", "items": { "type": "object", "properties": { "base": { "type": "string", "description": "Ticker base currency" }, "target": { "type": "string", "description": "Ticker target currency" }, "market": { "type": "object", "description": "Exchange information", "properties": { "name": { "type": "string", "description": "Exchange name" }, "identifier": { "type": "string", "description": "Exchange identifier" }, "has_trading_incentive": { "type": "boolean", "description": "Exchange trading incentive" } } }, "last": { "type": "number", "description": "Last price" }, "volume": { "type": "number", "description": "Trading volume" }, "converted_last": { "type": "object", "description": "Converted last price", "properties": { "btc": { "type": "number" }, "eth": { "type": "number" }, "usd": { "type": "number" } } }, "converted_volume": { "type": "object", "description": "Converted trading volume", "properties": { "btc": { "type": "number" }, "eth": { "type": "number" }, "usd": { "type": "number" } } }, "trust_score": { "type": "string", "nullable": true, "description": "Trust score" }, "bid_ask_spread_percentage": { "type": "number", "description": "Bid-ask spread percentage" }, "timestamp": { "type": "string", "description": "Ticker timestamp" }, "last_traded_at": { "type": "string", "description": "Last traded timestamp" }, "last_fetch_at": { "type": "string", "description": "Last fetch timestamp" }, "is_anomaly": { "type": "boolean", "description": "Whether ticker is anomalous" }, "is_stale": { "type": "boolean", "description": "Whether ticker is stale" }, "trade_url": { "type": "string", "description": "Trade URL" }, "token_info_url": { "type": "string", "nullable": true, "description": "Token info URL" }, "coin_id": { "type": "string", "description": "Base currency coin ID" }, "target_coin_id": { "type": "string", "description": "Target currency coin ID" }, "coin_mcap_usd": { "type": "number", "description": "Coin market cap in USD" } } } }, "status_updates": { "type": "array", "description": "Status updates", "items": { "type": "object", "properties": { "description": { "type": "string", "description": "Status update description" }, "category": { "type": "string", "description": "Status update category" }, "created_at": { "type": "string", "description": "Status update creation time" }, "user": { "type": "string", "description": "Status update user" }, "user_title": { "type": "string", "description": "Status update user title" }, "pin": { "type": "boolean", "description": "Whether status update is pinned" }, "project": { "type": "object", "description": "Project information", "properties": { "type": { "type": "string", "description": "Project type" }, "id": { "type": "string", "description": "Project ID" }, "name": { "type": "string", "description": "Project name" }, "image": { "type": "object", "description": "Project image URLs", "properties": { "thumb": { "type": "string" }, "small": { "type": "string" }, "large": { "type": "string" } } } } } } } } } }, "ExchangeVolumeChart": { "type": "array", "description": "Volume chart data points as [timestamp, volume_in_btc] pairs", "items": { "type": "array", "items": { "oneOf": [ { "type": "number" }, { "type": "string" } ] } } }, "DerivativesTickers": { "type": "array", "items": { "type": "object", "required": [ "market", "symbol", "index_id", "price", "price_percentage_change_24h", "contract_type", "index", "basis", "spread", "funding_rate", "open_interest", "volume_24h", "last_traded_at", "expired_at" ], "properties": { "market": { "type": "string", "description": "Derivative market name" }, "symbol": { "type": "string", "description": "Derivative ticker symbol" }, "index_id": { "type": "string", "description": "Derivative underlying asset" }, "price": { "type": "string", "description": "Derivative ticker price" }, "price_percentage_change_24h": { "type": "number", "description": "Derivative ticker price percentage change in 24 hours" }, "contract_type": { "type": "string", "description": "Derivative contract type" }, "index": { "type": "number", "description": "Derivative underlying asset price" }, "basis": { "type": "number", "description": "Difference of derivative price and index price" }, "spread": { "type": "number", "description": "Derivative bid-ask spread" }, "funding_rate": { "type": "number", "description": "Derivative funding rate" }, "open_interest": { "type": "number", "description": "Derivative open interest" }, "volume_24h": { "type": "number", "description": "Derivative trading volume in 24 hours" }, "last_traded_at": { "type": "number", "description": "Derivative last traded time in UNIX timestamp" }, "expired_at": { "type": "number", "nullable": true, "description": "Derivative expiry time in UNIX timestamp" } } } }, "DerivativesExchangesID": { "type": "object", "required": [ "name", "open_interest_btc", "trade_volume_24h_btc", "number_of_perpetual_pairs", "number_of_futures_pairs", "image", "year_established", "country", "description", "url" ], "properties": { "name": { "type": "string", "description": "Derivatives exchange name" }, "open_interest_btc": { "type": "number", "nullable": true, "description": "Derivatives exchange open interest in BTC" }, "trade_volume_24h_btc": { "type": "string", "description": "Derivatives exchange trade volume in BTC in 24 hours" }, "number_of_perpetual_pairs": { "type": "integer", "description": "Number of perpetual pairs in the derivatives exchange" }, "number_of_futures_pairs": { "type": "integer", "description": "Number of futures pairs in the derivatives exchange" }, "image": { "type": "string", "description": "Derivatives exchange image URL" }, "year_established": { "type": "integer", "nullable": true, "description": "Derivatives exchange established year" }, "country": { "type": "string", "nullable": true, "description": "Derivatives exchange incorporated country" }, "description": { "type": "string", "description": "Derivatives exchange description" }, "url": { "type": "string", "description": "Derivatives exchange website URL" }, "tickers": { "type": "array", "description": "Derivative tickers data, available when include_tickers is specified", "items": { "type": "object", "required": [ "symbol", "base", "target", "coin_id", "target_coin_id", "trade_url", "contract_type", "last", "h24_percentage_change", "index", "index_basis_percentage", "bid_ask_spread", "funding_rate", "open_interest_usd", "h24_volume", "converted_volume", "converted_last", "last_traded", "expired_at" ], "properties": { "symbol": { "type": "string", "description": "Derivative ticker symbol" }, "base": { "type": "string", "description": "Derivative base asset" }, "target": { "type": "string", "description": "Derivative target asset" }, "coin_id": { "type": "string", "description": "Derivative base asset coin ID" }, "target_coin_id": { "type": "string", "description": "Derivative target asset coin ID" }, "trade_url": { "type": "string", "description": "Derivative trade URL" }, "contract_type": { "type": "string", "description": "Derivative contract type" }, "last": { "type": "number", "description": "Derivative last price" }, "h24_percentage_change": { "type": "number", "description": "Derivative price percentage change in 24 hours" }, "index": { "type": "number", "description": "Derivative underlying asset price" }, "index_basis_percentage": { "type": "number", "description": "Difference of derivative price and index price in percentage" }, "bid_ask_spread": { "type": "number", "description": "Derivative bid-ask spread" }, "funding_rate": { "type": "number", "description": "Derivative funding rate" }, "open_interest_usd": { "type": "number", "description": "Derivative open interest in USD" }, "h24_volume": { "type": "number", "description": "Derivative volume in 24 hours" }, "converted_volume": { "type": "object", "description": "Derivative converted volume", "properties": { "btc": { "type": "string" }, "eth": { "type": "string" }, "usd": { "type": "string" } } }, "converted_last": { "type": "object", "description": "Derivative converted last price", "properties": { "btc": { "type": "string" }, "eth": { "type": "string" }, "usd": { "type": "string" } } }, "last_traded": { "type": "number", "description": "Derivative last traded time in UNIX timestamp" }, "expired_at": { "type": "number", "nullable": true, "description": "Derivative expiry time in UNIX timestamp" } } } } } }, "DerivativesExchanges": { "type": "array", "items": { "type": "object", "required": [ "name", "id", "open_interest_btc", "trade_volume_24h_btc", "number_of_perpetual_pairs", "number_of_futures_pairs", "image", "year_established", "country", "description", "url" ], "properties": { "name": { "type": "string", "description": "Derivatives exchange name" }, "id": { "type": "string", "description": "Derivatives exchange ID" }, "open_interest_btc": { "type": "number", "description": "Derivatives exchange open interest in BTC" }, "trade_volume_24h_btc": { "type": "string", "description": "Derivatives exchange trade volume in BTC in 24 hours" }, "number_of_perpetual_pairs": { "type": "integer", "description": "Number of perpetual pairs in the derivatives exchange" }, "number_of_futures_pairs": { "type": "integer", "description": "Number of futures pairs in the derivatives exchange" }, "image": { "type": "string", "description": "Derivatives exchange image URL" }, "year_established": { "type": "integer", "nullable": true, "description": "Derivatives exchange established year" }, "country": { "type": "string", "nullable": true, "description": "Derivatives exchange incorporated country" }, "description": { "type": "string", "description": "Derivatives exchange description" }, "url": { "type": "string", "description": "Derivatives exchange website URL" } } } }, "DerivativesExchangesList": { "type": "array", "items": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "string", "description": "Derivatives exchange ID" }, "name": { "type": "string", "description": "Derivatives exchange name" } } } }, "PublicTreasury": { "oneOf": [ { "title": "CompanyTreasury", "type": "object", "required": [ "total_holdings", "total_value_usd", "market_cap_dominance", "companies" ], "properties": { "total_holdings": { "type": "number", "description": "Total crypto holdings" }, "total_value_usd": { "type": "number", "description": "Total crypto holdings value in USD" }, "market_cap_dominance": { "type": "number", "description": "Market cap dominance percentage" }, "companies": { "type": "array", "description": "List of companies holding crypto", "items": { "type": "object", "required": [ "name", "symbol", "country", "total_holdings", "total_entry_value_usd", "total_current_value_usd", "percentage_of_total_supply" ], "properties": { "name": { "type": "string", "description": "Company name" }, "symbol": { "type": "string", "nullable": true, "description": "Company ticker symbol" }, "country": { "type": "string", "description": "Country code" }, "total_holdings": { "type": "number", "description": "Total crypto holdings" }, "total_entry_value_usd": { "type": "number", "description": "Total entry value in USD" }, "total_current_value_usd": { "type": "number", "description": "Total current value of crypto holdings in USD" }, "percentage_of_total_supply": { "type": "number", "description": "Percentage of total crypto supply" } } } } } }, { "title": "GovernmentTreasury", "type": "object", "required": [ "total_holdings", "total_value_usd", "market_cap_dominance", "governments" ], "properties": { "total_holdings": { "type": "number", "description": "Total crypto holdings" }, "total_value_usd": { "type": "number", "description": "Total crypto holdings value in USD" }, "market_cap_dominance": { "type": "number", "description": "Market cap dominance percentage" }, "governments": { "type": "array", "description": "List of governments holding crypto", "items": { "type": "object", "required": [ "name", "symbol", "country", "total_holdings", "total_entry_value_usd", "total_current_value_usd", "percentage_of_total_supply" ], "properties": { "name": { "type": "string", "description": "Government name" }, "symbol": { "type": "string", "nullable": true, "description": "Government ticker symbol" }, "country": { "type": "string", "description": "Country code" }, "total_holdings": { "type": "number", "description": "Total crypto holdings" }, "total_entry_value_usd": { "type": "number", "description": "Total entry value in USD" }, "total_current_value_usd": { "type": "number", "description": "Total current value of crypto holdings in USD" }, "percentage_of_total_supply": { "type": "number", "description": "Percentage of total crypto supply" } } } } } } ] }, "PublicTreasuryEntity": { "type": "object", "required": [ "name", "id", "type", "symbol", "country", "website_url", "twitter_screen_name", "total_treasury_value_usd", "unrealized_pnl", "m_nav", "total_asset_value_per_share_usd", "holdings" ], "properties": { "name": { "type": "string", "description": "Entity name" }, "id": { "type": "string", "description": "Entity ID" }, "type": { "type": "string", "description": "Entity type: company or government" }, "symbol": { "type": "string", "nullable": true, "description": "Stock market ticker symbol" }, "country": { "type": "string", "description": "Country code" }, "website_url": { "type": "string", "description": "Official website URL" }, "twitter_screen_name": { "type": "string", "description": "Official Twitter handle" }, "total_treasury_value_usd": { "type": "number", "description": "Total current value of all holdings in USD" }, "unrealized_pnl": { "type": "number", "description": "Unrealized profit and loss (current value minus total entry value)" }, "m_nav": { "type": "number", "description": "Market to net asset value ratio" }, "total_asset_value_per_share_usd": { "type": "number", "description": "Total asset value per share in USD" }, "holdings": { "type": "array", "description": "List of cryptocurrency assets held by the entity", "items": { "type": "object", "required": [ "coin_id", "amount", "percentage_of_total_supply", "amount_per_share", "entity_value_usd_percentage", "current_value_usd", "total_entry_value_usd", "average_entry_value_usd", "unrealized_pnl" ], "properties": { "coin_id": { "type": "string", "description": "Coin ID" }, "amount": { "type": "number", "description": "Amount of cryptocurrency held" }, "percentage_of_total_supply": { "type": "number", "description": "Percentage of total crypto supply" }, "amount_per_share": { "type": "number", "description": "Amount of cryptocurrency per share" }, "entity_value_usd_percentage": { "type": "number", "description": "Percentage of entity's total treasury value" }, "current_value_usd": { "type": "number", "description": "Current value of holdings in USD" }, "total_entry_value_usd": { "type": "number", "description": "Total entry cost in USD" }, "average_entry_value_usd": { "type": "number", "description": "Average entry cost per unit in USD" }, "unrealized_pnl": { "type": "number", "description": "Unrealized profit and loss for this holding" }, "holding_amount_change": { "type": "object", "description": "Holding amount changes over different timeframes", "properties": { "7d": { "type": "number", "x-stainless-naming": { "python": { "property_name": "period_7d" } } }, "14d": { "type": "number", "x-stainless-naming": { "python": { "property_name": "period_14d" } } }, "30d": { "type": "number", "x-stainless-naming": { "python": { "property_name": "period_30d" } } }, "90d": { "type": "number", "x-stainless-naming": { "python": { "property_name": "period_90d" } } }, "1y": { "type": "number", "x-stainless-naming": { "python": { "property_name": "period_1y" } } }, "ytd": { "type": "number" } } }, "holding_change_percentage": { "type": "object", "description": "Holding change percentages over different timeframes", "properties": { "7d": { "type": "number", "x-stainless-naming": { "python": { "property_name": "period_7d" } } }, "14d": { "type": "number", "x-stainless-naming": { "python": { "property_name": "period_14d" } } }, "30d": { "type": "number", "x-stainless-naming": { "python": { "property_name": "period_30d" } } }, "90d": { "type": "number", "x-stainless-naming": { "python": { "property_name": "period_90d" } } }, "1y": { "type": "number", "x-stainless-naming": { "python": { "property_name": "period_1y" } } }, "ytd": { "type": "number" } } } } } } } }, "PublicTreasuryEntityChart": { "type": "object", "required": [ "holdings", "holding_value_in_usd" ], "properties": { "holdings": { "type": "array", "description": "Historical holdings data as [timestamp, amount] pairs", "items": { "type": "array", "items": { "type": "number" } } }, "holding_value_in_usd": { "type": "array", "description": "Historical holdings value in USD as [timestamp, value_usd] pairs", "items": { "type": "array", "items": { "type": "number" } } } } }, "PublicTreasuryTransactionHistory": { "type": "object", "required": [ "transactions" ], "properties": { "transactions": { "type": "array", "items": { "type": "object", "required": [ "date", "source_url", "coin_id", "type", "holding_net_change", "transaction_value_usd", "holding_balance", "average_entry_value_usd" ], "properties": { "date": { "type": "number", "description": "Transaction date in UNIX timestamp" }, "source_url": { "type": "string", "description": "Source document URL" }, "coin_id": { "type": "string", "description": "Coin ID" }, "type": { "type": "string", "description": "Transaction type", "enum": [ "buy", "sell" ] }, "holding_net_change": { "type": "number", "description": "Net change in holdings after the transaction" }, "transaction_value_usd": { "type": "number", "description": "Transaction value in USD" }, "holding_balance": { "type": "number", "description": "Total holding balance after the transaction" }, "average_entry_value_usd": { "type": "number", "description": "Average entry value in USD after the transaction" } } } } } }, "EntitiesList": { "type": "array", "items": { "type": "object", "required": [ "id", "symbol", "name", "country" ], "properties": { "id": { "type": "string", "description": "Entity ID" }, "symbol": { "type": "string", "description": "Ticker symbol of public company" }, "name": { "type": "string", "description": "Entity name" }, "country": { "type": "string", "description": "Country code" } } } }, "NFTData": { "type": "object", "required": [ "id", "web_slug", "contract_address", "asset_platform_id", "name", "symbol", "image", "banner_image", "description", "native_currency", "native_currency_symbol", "market_cap_rank", "floor_price", "market_cap", "volume_24h", "floor_price_in_usd_24h_percentage_change", "floor_price_24h_percentage_change", "market_cap_24h_percentage_change", "volume_24h_percentage_change", "number_of_unique_addresses", "number_of_unique_addresses_24h_percentage_change", "volume_in_usd_24h_percentage_change", "total_supply", "one_day_sales", "one_day_sales_24h_percentage_change", "one_day_average_sale_price", "one_day_average_sale_price_24h_percentage_change", "links", "floor_price_7d_percentage_change", "floor_price_14d_percentage_change", "floor_price_30d_percentage_change", "floor_price_60d_percentage_change", "floor_price_1y_percentage_change", "explorers", "user_favorites_count", "ath", "ath_change_percentage", "ath_date" ], "properties": { "id": { "type": "string", "description": "NFT collection ID" }, "web_slug": { "type": "string", "description": "NFT collection web slug" }, "contract_address": { "type": "string", "description": "NFT collection contract address" }, "asset_platform_id": { "type": "string", "description": "NFT collection asset platform ID" }, "name": { "type": "string", "description": "NFT collection name" }, "symbol": { "type": "string", "description": "NFT collection symbol" }, "image": { "type": "object", "description": "NFT collection image URLs", "properties": { "small": { "type": "string" }, "small_2x": { "type": "string" } } }, "banner_image": { "type": "string", "description": "NFT collection banner image URL" }, "description": { "type": "string", "description": "NFT collection description" }, "native_currency": { "type": "string", "description": "NFT collection native currency" }, "native_currency_symbol": { "type": "string", "description": "NFT collection native currency symbol" }, "market_cap_rank": { "type": "integer", "nullable": true, "description": "NFT collection market cap rank" }, "floor_price": { "type": "object", "description": "NFT collection floor price", "properties": { "native_currency": { "type": "number" }, "usd": { "type": "number" } } }, "market_cap": { "type": "object", "description": "NFT collection market cap", "properties": { "native_currency": { "type": "number" }, "usd": { "type": "number" } } }, "volume_24h": { "type": "object", "description": "NFT collection volume in 24 hours", "properties": { "native_currency": { "type": "number" }, "usd": { "type": "number" } } }, "floor_price_in_usd_24h_percentage_change": { "type": "number", "description": "NFT collection floor price in USD 24 hours percentage change" }, "floor_price_24h_percentage_change": { "type": "object", "description": "NFT collection floor price 24 hours percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "market_cap_24h_percentage_change": { "type": "object", "description": "NFT collection market cap 24 hours percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "volume_24h_percentage_change": { "type": "object", "description": "NFT collection volume in 24 hours percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "number_of_unique_addresses": { "type": "number", "description": "Number of unique addresses owning the NFTs" }, "number_of_unique_addresses_24h_percentage_change": { "type": "number", "description": "Number of unique addresses 24 hours percentage change" }, "volume_in_usd_24h_percentage_change": { "type": "number", "description": "NFT collection volume in USD 24 hours percentage change" }, "total_supply": { "type": "number", "description": "NFT collection total supply" }, "one_day_sales": { "type": "number", "nullable": true, "description": "NFT collection one day sales" }, "one_day_sales_24h_percentage_change": { "type": "number", "description": "NFT collection one day sales 24 hours percentage change" }, "one_day_average_sale_price": { "type": "number", "nullable": true, "description": "NFT collection one day average sale price" }, "one_day_average_sale_price_24h_percentage_change": { "type": "number", "description": "NFT collection one day average sale price 24 hours percentage change" }, "links": { "type": "object", "description": "NFT collection links", "properties": { "homepage": { "type": "string" }, "twitter": { "type": "string" }, "discord": { "type": "string" } } }, "floor_price_7d_percentage_change": { "type": "object", "description": "NFT collection floor price 7 days percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "floor_price_14d_percentage_change": { "type": "object", "description": "NFT collection floor price 14 days percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "floor_price_30d_percentage_change": { "type": "object", "description": "NFT collection floor price 30 days percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "floor_price_60d_percentage_change": { "type": "object", "description": "NFT collection floor price 60 days percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "floor_price_1y_percentage_change": { "type": "object", "description": "NFT collection floor price 1 year percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "explorers": { "type": "array", "description": "NFT collection block explorer links", "items": { "type": "object", "properties": { "name": { "type": "string" }, "link": { "type": "string" } } } }, "user_favorites_count": { "type": "integer", "description": "NFT collection user favorites count" }, "ath": { "type": "object", "description": "NFT collection all time highs", "properties": { "native_currency": { "type": "number" }, "usd": { "type": "number" } } }, "ath_change_percentage": { "type": "object", "description": "NFT collection all time highs change percentage", "properties": { "native_currency": { "type": "number" }, "usd": { "type": "number" } } }, "ath_date": { "type": "object", "description": "NFT collection all time highs date", "properties": { "native_currency": { "type": "string", "format": "date-time" }, "usd": { "type": "string", "format": "date-time" } } } } }, "NFTTickers": { "type": "object", "required": [ "tickers" ], "properties": { "tickers": { "type": "array", "items": { "type": "object", "required": [ "floor_price_in_native_currency", "h24_volume_in_native_currency", "native_currency", "native_currency_symbol", "updated_at", "nft_marketplace_id", "name", "image", "nft_collection_url" ], "properties": { "floor_price_in_native_currency": { "type": "number", "description": "NFT collection floor price in native currency" }, "h24_volume_in_native_currency": { "type": "number", "description": "NFT collection volume in 24 hours in native currency" }, "native_currency": { "type": "string", "description": "NFT collection native currency" }, "native_currency_symbol": { "type": "string", "description": "NFT collection native currency symbol" }, "updated_at": { "type": "string", "description": "Last updated time" }, "nft_marketplace_id": { "type": "string", "description": "NFT marketplace ID" }, "name": { "type": "string", "description": "NFT marketplace name" }, "image": { "type": "string", "description": "NFT marketplace image URL" }, "nft_collection_url": { "type": "string", "description": "NFT collection URL in the NFT marketplace" } } } } } }, "NFTMarketChart": { "type": "object", "required": [ "floor_price_usd", "floor_price_native", "h24_volume_usd", "h24_volume_native", "market_cap_usd", "market_cap_native" ], "properties": { "floor_price_usd": { "type": "array", "description": "NFT collection floor price in USD as [timestamp, price] pairs", "items": { "type": "array", "items": { "type": "number" } } }, "floor_price_native": { "type": "array", "description": "NFT collection floor price in native currency as [timestamp, price] pairs", "items": { "type": "array", "items": { "type": "number" } } }, "h24_volume_usd": { "type": "array", "description": "NFT collection 24h volume in USD as [timestamp, volume] pairs", "items": { "type": "array", "items": { "type": "number" } } }, "h24_volume_native": { "type": "array", "description": "NFT collection 24h volume in native currency as [timestamp, volume] pairs", "items": { "type": "array", "items": { "type": "number" } } }, "market_cap_usd": { "type": "array", "description": "NFT collection market cap in USD as [timestamp, market_cap] pairs", "items": { "type": "array", "items": { "type": "number" } } }, "market_cap_native": { "type": "array", "description": "NFT collection market cap in native currency as [timestamp, market_cap] pairs", "items": { "type": "array", "items": { "type": "number" } } } } }, "NFTsMarkets": { "type": "array", "items": { "type": "object", "required": [ "id", "contract_address", "asset_platform_id", "name", "symbol", "image", "description", "native_currency", "native_currency_symbol", "floor_price", "market_cap", "volume_24h", "floor_price_in_usd_24h_percentage_change", "floor_price_24h_percentage_change", "market_cap_24h_percentage_change", "volume_24h_percentage_change", "number_of_unique_addresses", "number_of_unique_addresses_24h_percentage_change", "volume_in_usd_24h_percentage_change", "total_supply", "one_day_sales", "one_day_sales_24h_percentage_change", "one_day_average_sale_price", "one_day_average_sale_price_24h_percentage_change" ], "properties": { "id": { "type": "string", "description": "NFT collection ID" }, "contract_address": { "type": "string", "nullable": true, "description": "NFT collection contract address" }, "asset_platform_id": { "type": "string", "description": "NFT collection asset platform ID" }, "name": { "type": "string", "description": "NFT collection name" }, "symbol": { "type": "string", "description": "NFT collection symbol" }, "image": { "type": "object", "description": "NFT collection image URLs", "properties": { "small": { "type": "string" }, "small_2x": { "type": "string" } } }, "description": { "type": "string", "nullable": true, "description": "NFT collection description" }, "native_currency": { "type": "string", "description": "NFT collection native currency" }, "native_currency_symbol": { "type": "string", "description": "NFT collection native currency symbol" }, "floor_price": { "type": "object", "description": "NFT collection floor price", "properties": { "native_currency": { "type": "number" }, "usd": { "type": "number" } } }, "market_cap": { "type": "object", "description": "NFT collection market cap", "properties": { "native_currency": { "type": "number" }, "usd": { "type": "number" } } }, "volume_24h": { "type": "object", "description": "NFT collection volume in 24 hours", "properties": { "native_currency": { "type": "number" }, "usd": { "type": "number" } } }, "floor_price_in_usd_24h_percentage_change": { "type": "number", "description": "NFT collection floor price in USD 24 hours percentage change" }, "floor_price_24h_percentage_change": { "type": "object", "description": "NFT collection floor price 24 hours percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "market_cap_24h_percentage_change": { "type": "object", "description": "NFT collection market cap 24 hours percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "volume_24h_percentage_change": { "type": "object", "description": "NFT collection volume in 24 hours percentage change", "properties": { "usd": { "type": "number" }, "native_currency": { "type": "number" } } }, "number_of_unique_addresses": { "type": "number", "nullable": true, "description": "Number of unique addresses owning the NFTs" }, "number_of_unique_addresses_24h_percentage_change": { "type": "number", "description": "Number of unique addresses 24 hours percentage change" }, "volume_in_usd_24h_percentage_change": { "type": "number", "description": "NFT collection volume in USD 24 hours percentage change" }, "total_supply": { "type": "number", "nullable": true, "description": "NFT collection total supply" }, "one_day_sales": { "type": "number", "nullable": true, "description": "NFT collection one day sales" }, "one_day_sales_24h_percentage_change": { "type": "number", "description": "NFT collection one day sales 24 hours percentage change" }, "one_day_average_sale_price": { "type": "number", "nullable": true, "description": "NFT collection one day average sale price" }, "one_day_average_sale_price_24h_percentage_change": { "type": "number", "description": "NFT collection one day average sale price 24 hours percentage change" } } } }, "NFTsList": { "type": "array", "items": { "type": "object", "required": [ "id", "contract_address", "name", "asset_platform_id", "symbol" ], "properties": { "id": { "type": "string", "description": "NFT collection ID" }, "contract_address": { "type": "string", "description": "NFT collection contract address" }, "name": { "type": "string", "description": "NFT collection name" }, "asset_platform_id": { "type": "string", "description": "NFT collection asset platform ID" }, "symbol": { "type": "string", "description": "NFT collection symbol" } } } }, "Global": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "active_cryptocurrencies", "upcoming_icos", "ongoing_icos", "ended_icos", "markets", "total_market_cap", "total_volume", "market_cap_percentage", "market_cap_change_percentage_24h_usd", "volume_change_percentage_24h_usd", "updated_at" ], "properties": { "active_cryptocurrencies": { "type": "integer", "description": "Number of active cryptocurrencies" }, "upcoming_icos": { "type": "integer", "description": "Number of upcoming ICOs" }, "ongoing_icos": { "type": "integer", "description": "Number of ongoing ICOs" }, "ended_icos": { "type": "integer", "description": "Number of ended ICOs" }, "markets": { "type": "integer", "description": "Number of exchanges" }, "total_market_cap": { "type": "object", "description": "Total cryptocurrency market cap by currency", "additionalProperties": { "type": "number" } }, "total_volume": { "type": "object", "description": "Total cryptocurrency volume by currency", "additionalProperties": { "type": "number" } }, "market_cap_percentage": { "type": "object", "description": "Market cap percentage by coin", "additionalProperties": { "type": "number" } }, "market_cap_change_percentage_24h_usd": { "type": "number", "description": "Market cap change percentage in 24 hours in USD" }, "volume_change_percentage_24h_usd": { "type": "number", "description": "Volume change percentage in 24 hours in USD" }, "updated_at": { "type": "integer", "description": "Last updated time in UNIX timestamp" } } } } }, "GlobalDeFi": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "defi_market_cap", "eth_market_cap", "defi_to_eth_ratio", "trading_volume_24h", "defi_dominance", "top_coin_name", "top_coin_defi_dominance" ], "properties": { "defi_market_cap": { "type": "string", "description": "DeFi market cap" }, "eth_market_cap": { "type": "string", "description": "ETH market cap" }, "defi_to_eth_ratio": { "type": "string", "description": "DeFi to ETH ratio" }, "trading_volume_24h": { "type": "string", "description": "DeFi trading volume in 24 hours" }, "defi_dominance": { "type": "string", "description": "DeFi dominance percentage" }, "top_coin_name": { "type": "string", "description": "DeFi top coin name" }, "top_coin_defi_dominance": { "type": "number", "description": "DeFi top coin dominance percentage" } } } } }, "GlobalMarketCapChart": { "type": "object", "required": [ "market_cap_chart" ], "properties": { "market_cap_chart": { "type": "object", "required": [ "market_cap", "volume" ], "properties": { "market_cap": { "type": "array", "description": "Market cap data as [timestamp, market_cap] pairs", "items": { "type": "array", "items": { "type": "number" } } }, "volume": { "type": "array", "description": "Volume data as [timestamp, volume] pairs", "items": { "type": "array", "items": { "type": "number" } } } } } } }, "TrendingSearch": { "type": "object", "required": [ "coins", "nfts", "categories" ], "properties": { "coins": { "type": "array", "items": { "type": "object", "required": [ "item" ], "properties": { "item": { "type": "object", "required": [ "id", "coin_id", "name", "symbol", "market_cap_rank", "thumb", "small", "large", "slug", "price_btc", "score", "data" ], "properties": { "id": { "type": "string", "description": "Coin ID" }, "coin_id": { "type": "integer", "description": "Coin internal ID" }, "name": { "type": "string", "description": "Coin name" }, "symbol": { "type": "string", "description": "Coin symbol" }, "market_cap_rank": { "type": "integer", "description": "Coin market cap rank" }, "thumb": { "type": "string", "description": "Coin thumb image URL" }, "small": { "type": "string", "description": "Coin small image URL" }, "large": { "type": "string", "description": "Coin large image URL" }, "slug": { "type": "string", "description": "Coin web slug" }, "price_btc": { "type": "number", "description": "Coin price in BTC" }, "score": { "type": "integer", "description": "Coin trending rank (0-based)" }, "data": { "type": "object", "required": [ "price", "price_btc", "price_change_percentage_24h", "market_cap", "market_cap_btc", "total_volume", "total_volume_btc", "sparkline", "content" ], "properties": { "price": { "type": "number", "description": "Coin price in USD" }, "price_btc": { "type": "string", "description": "Coin price in BTC" }, "price_change_percentage_24h": { "type": "object", "description": "Coin price change percentage in 24 hours by currency", "additionalProperties": { "type": "number" } }, "market_cap": { "type": "string", "description": "Coin market cap in USD" }, "market_cap_btc": { "type": "string", "description": "Coin market cap in BTC" }, "total_volume": { "type": "string", "description": "Coin total volume in USD" }, "total_volume_btc": { "type": "string", "description": "Coin total volume in BTC" }, "sparkline": { "type": "string", "description": "Coin sparkline image URL" }, "content": { "type": "object", "nullable": true, "properties": { "title": { "type": "string" }, "description": { "type": "string" } } } } } } } } } }, "nfts": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "symbol", "thumb", "nft_contract_id", "native_currency_symbol", "floor_price_in_native_currency", "floor_price_24h_percentage_change", "data" ], "properties": { "id": { "type": "string", "description": "NFT collection ID" }, "name": { "type": "string", "description": "NFT collection name" }, "symbol": { "type": "string", "description": "NFT collection symbol" }, "thumb": { "type": "string", "description": "NFT collection thumb image URL" }, "nft_contract_id": { "type": "integer", "description": "NFT contract internal ID" }, "native_currency_symbol": { "type": "string", "description": "NFT collection native currency symbol" }, "floor_price_in_native_currency": { "type": "number", "description": "NFT collection floor price in native currency" }, "floor_price_24h_percentage_change": { "type": "number", "description": "NFT collection floor price 24 hours percentage change" }, "data": { "type": "object", "required": [ "floor_price", "floor_price_in_usd_24h_percentage_change", "h24_volume", "h24_average_sale_price", "sparkline", "content" ], "properties": { "floor_price": { "type": "string", "description": "NFT collection floor price" }, "floor_price_in_usd_24h_percentage_change": { "type": "string", "description": "NFT collection floor price in USD 24 hours percentage change" }, "h24_volume": { "type": "string", "description": "NFT collection volume in 24 hours" }, "h24_average_sale_price": { "type": "string", "description": "NFT collection 24 hours average sale price" }, "sparkline": { "type": "string", "description": "NFT collection sparkline image URL" }, "content": { "type": "object", "nullable": true, "properties": { "title": { "type": "string" }, "description": { "type": "string" } } } } } } } }, "categories": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "top_3_coins_images", "market_cap_1h_change", "slug", "coins_count", "data" ], "properties": { "id": { "type": "integer", "description": "Category ID" }, "name": { "type": "string", "description": "Category name" }, "top_3_coins_images": { "type": "array", "description": "Top 3 coins image URLs in the category", "items": { "type": "string" } }, "market_cap_1h_change": { "type": "number", "description": "Category market cap 1 hour change" }, "slug": { "type": "string", "description": "Category web slug" }, "coins_count": { "type": "string", "description": "Number of coins in the category" }, "data": { "type": "object", "required": [ "market_cap", "market_cap_btc", "total_volume", "total_volume_btc", "market_cap_change_percentage_24h", "sparkline" ], "properties": { "market_cap": { "type": "number", "description": "Category market cap" }, "market_cap_btc": { "type": "number", "description": "Category market cap in BTC" }, "total_volume": { "type": "number", "description": "Category total volume" }, "total_volume_btc": { "type": "number", "description": "Category total volume in BTC" }, "market_cap_change_percentage_24h": { "type": "object", "description": "Category market cap change percentage in 24 hours by currency", "additionalProperties": { "type": "number" } }, "sparkline": { "type": "string", "description": "Category sparkline image URL" } } } } } } } }, "News": { "type": "array", "items": { "type": "object", "required": [ "title", "url", "image", "author", "posted_at", "type", "source_name", "related_coin_ids" ], "properties": { "title": { "type": "string", "description": "News article title" }, "url": { "type": "string", "description": "News article URL" }, "image": { "type": "string", "description": "News article image URL" }, "author": { "type": "string", "description": "News article author" }, "posted_at": { "type": "string", "description": "News article published timestamp in ISO 8601 format" }, "type": { "type": "string", "description": "News article type", "enum": [ "news", "guide" ] }, "source_name": { "type": "string", "description": "News article source name" }, "related_coin_ids": { "type": "array", "description": "Related coin IDs", "items": { "type": "string" } } } } }, "ExchangeRates": { "type": "object", "required": [ "rates" ], "properties": { "rates": { "type": "object", "description": "Exchange rates keyed by currency code", "additionalProperties": { "type": "object", "required": [ "name", "unit", "value", "type" ], "properties": { "name": { "type": "string", "description": "Currency name" }, "unit": { "type": "string", "description": "Currency unit symbol" }, "value": { "type": "number", "description": "Exchange rate value relative to BTC" }, "type": { "type": "string", "description": "Currency type: crypto, fiat, or commodity" } } } } } }, "PoolAddressItem": { "type": "object", "required": [ "id", "type", "attributes", "relationships" ], "properties": { "id": { "type": "string", "description": "Pool identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "base_token_price_usd", "base_token_price_native_currency", "quote_token_price_usd", "quote_token_price_native_currency", "base_token_price_quote_token", "quote_token_price_base_token", "address", "name", "pool_name", "pool_fee_percentage", "pool_created_at", "fdv_usd", "market_cap_usd", "price_change_percentage", "transactions", "volume_usd", "reserve_in_usd", "locked_liquidity_percentage" ], "properties": { "base_token_price_usd": { "type": "string", "description": "Base token price in USD" }, "base_token_price_native_currency": { "type": "string", "description": "Base token price in native currency" }, "base_token_balance": { "type": "string", "description": "Base token balance in pool" }, "base_token_liquidity_usd": { "type": "string", "description": "Base token liquidity in USD" }, "quote_token_price_usd": { "type": "string", "description": "Quote token price in USD" }, "quote_token_price_native_currency": { "type": "string", "description": "Quote token price in native currency" }, "quote_token_balance": { "type": "string", "description": "Quote token balance in pool" }, "quote_token_liquidity_usd": { "type": "string", "description": "Quote token liquidity in USD" }, "base_token_price_quote_token": { "type": "string", "description": "Base token price in quote token" }, "quote_token_price_base_token": { "type": "string", "description": "Quote token price in base token" }, "address": { "type": "string", "description": "Pool contract address" }, "name": { "type": "string", "description": "Pool name with fee tier" }, "pool_name": { "type": "string", "description": "Pool name without fee tier" }, "pool_fee_percentage": { "type": "string", "description": "Pool fee percentage" }, "pool_created_at": { "type": "string", "description": "Pool creation timestamp" }, "fdv_usd": { "type": "string", "nullable": true, "description": "Fully diluted valuation in USD" }, "market_cap_usd": { "type": "string", "nullable": true, "description": "Market cap in USD" }, "price_change_percentage": { "type": "object", "description": "Price change percentage over various timeframes", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "transactions": { "type": "object", "description": "Transaction counts over various timeframes", "properties": { "m5": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "m15": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "m30": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h1": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h6": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h24": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } } } }, "volume_usd": { "type": "object", "description": "Volume in USD over various timeframes", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "net_buy_volume_usd": { "type": "object", "description": "Net buy volume in USD over various timeframes", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "buy_volume_usd": { "type": "object", "description": "Buy volume in USD over various timeframes", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "sell_volume_usd": { "type": "object", "description": "Sell volume in USD over various timeframes", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "reserve_in_usd": { "type": "string", "description": "Total reserve in USD" }, "locked_liquidity_percentage": { "type": "string", "description": "Locked liquidity percentage" } } }, "relationships": { "type": "object", "description": "Related resources", "properties": { "base_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "quote_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "dex": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } } } } } }, "PoolAddressData": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PoolAddressItem" }, "included": { "type": "array", "description": "Included related resources, present when include parameter is specified", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "type": "object", "properties": { "address": { "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" }, "decimals": { "type": "integer" }, "image_url": { "type": "string" }, "coingecko_coin_id": { "type": "string" } } } } } } } }, "MultiPoolAddressData": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PoolAddressItem" } }, "included": { "type": "array", "description": "Included related resources, present when include parameter is specified", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "type": "object", "properties": { "address": { "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" }, "decimals": { "type": "integer" }, "image_url": { "type": "string" }, "coingecko_coin_id": { "type": "string" } } } } } } } }, "TrendingSearchPools": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "type", "attributes", "relationships" ], "properties": { "id": { "type": "string", "description": "Pool identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "trending_rank", "address", "name", "pool_created_at", "fdv_usd", "market_cap_usd", "volume_usd", "reserve_in_usd" ], "properties": { "trending_rank": { "type": "integer", "description": "Trending search rank (0-based)" }, "address": { "type": "string", "description": "Pool contract address" }, "name": { "type": "string", "description": "Pool name" }, "pool_created_at": { "type": "string", "description": "Pool creation timestamp" }, "fdv_usd": { "type": "string", "nullable": true, "description": "Fully diluted valuation in USD" }, "market_cap_usd": { "type": "string", "nullable": true, "description": "Market cap in USD" }, "volume_usd": { "type": "object", "description": "Volume in USD", "properties": { "h24": { "type": "string" } } }, "reserve_in_usd": { "type": "string", "nullable": true, "description": "Total reserve in USD" } } }, "relationships": { "type": "object", "description": "Related resources", "properties": { "base_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "quote_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "network": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "dex": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } } } } } } }, "included": { "type": "array", "description": "Included related resources, present when include parameter is specified", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "type": "object", "properties": { "address": { "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" }, "decimals": { "type": "integer" }, "image_url": { "type": "string", "nullable": true }, "coingecko_coin_id": { "type": "string", "nullable": true }, "coingecko_asset_platform_id": { "type": "string" } } } } } } } }, "TokenHoldersChart": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "Request ID" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "token_holders_list" ], "properties": { "token_holders_list": { "type": "array", "description": "Historical token holders as [timestamp, holder_count] pairs", "items": { "type": "array", "items": { "oneOf": [ { "type": "string" }, { "type": "integer" } ] } } } } } } }, "meta": { "type": "object", "properties": { "token": { "type": "object", "properties": { "name": { "type": "string", "description": "Token name" }, "symbol": { "type": "string", "description": "Token symbol" }, "coingecko_coin_id": { "type": "string", "nullable": true, "description": "CoinGecko coin ID" }, "address": { "type": "string", "description": "Token contract address" } } } } } } }, "TopTokenHolders": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "Token identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "last_updated_at", "holders" ], "properties": { "last_updated_at": { "type": "string", "description": "Data last updated timestamp" }, "holders": { "type": "array", "items": { "type": "object", "required": [ "rank", "address", "label", "amount", "percentage", "value" ], "properties": { "rank": { "type": "integer", "description": "Holder rank" }, "address": { "type": "string", "description": "Holder wallet address" }, "label": { "type": "string", "nullable": true, "description": "Address label" }, "amount": { "type": "string", "description": "Token amount held" }, "percentage": { "type": "string", "description": "Percentage of total supply held" }, "value": { "type": "string", "description": "Value of holdings in USD" }, "average_buy_price_usd": { "type": "string", "nullable": true, "description": "Average buy price in USD" }, "total_buy_count": { "type": "integer", "nullable": true, "description": "Total number of buy transactions" }, "total_sell_count": { "type": "integer", "nullable": true, "description": "Total number of sell transactions" }, "unrealized_pnl_usd": { "type": "string", "nullable": true, "description": "Unrealized PnL in USD" }, "unrealized_pnl_percentage": { "type": "string", "nullable": true, "description": "Unrealized PnL percentage" }, "realized_pnl_usd": { "type": "string", "nullable": true, "description": "Realized PnL in USD" }, "realized_pnl_percentage": { "type": "string", "nullable": true, "description": "Realized PnL percentage" }, "explorer_url": { "type": "string", "description": "Block explorer URL for the holder address" } } } } } } } } } }, "TopTokenTraders": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "Token identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "traders" ], "properties": { "traders": { "type": "array", "items": { "type": "object", "required": [ "address", "realized_pnl_usd", "unrealized_pnl_usd", "token_balance", "average_buy_price_usd", "average_sell_price_usd", "total_buy_count", "total_sell_count", "total_buy_token_amount", "total_sell_token_amount", "total_buy_usd", "total_sell_usd", "explorer_url" ], "properties": { "address": { "type": "string", "description": "Trader wallet address" }, "name": { "type": "string", "nullable": true, "description": "Address label name" }, "label": { "type": "string", "nullable": true, "description": "Address label" }, "type": { "type": "string", "nullable": true, "description": "Address type" }, "realized_pnl_usd": { "type": "string", "description": "Realized PnL in USD" }, "unrealized_pnl_usd": { "type": "string", "nullable": true, "description": "Unrealized PnL in USD" }, "token_balance": { "type": "string", "nullable": true, "description": "Current token balance" }, "average_buy_price_usd": { "type": "string", "description": "Average buy price in USD" }, "average_sell_price_usd": { "type": "string", "description": "Average sell price in USD" }, "total_buy_count": { "type": "integer", "description": "Total number of buy transactions" }, "total_sell_count": { "type": "integer", "description": "Total number of sell transactions" }, "total_buy_token_amount": { "type": "string", "description": "Total buy token amount" }, "total_sell_token_amount": { "type": "string", "description": "Total sell token amount" }, "total_buy_usd": { "type": "string", "description": "Total buy amount in USD" }, "total_sell_usd": { "type": "string", "description": "Total sell amount in USD" }, "explorer_url": { "type": "string", "description": "Block explorer URL for the trader address" } } } } } } } } } }, "TokenTrades": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "Trade identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "pool_address", "pool_dex", "block_number", "tx_hash", "tx_from_address", "from_token_amount", "to_token_amount", "price_from_in_currency_token", "price_to_in_currency_token", "price_from_in_usd", "price_to_in_usd", "block_timestamp", "kind", "volume_in_usd", "from_token_address", "to_token_address" ], "properties": { "pool_address": { "type": "string", "description": "Pool contract address where the trade occurred" }, "pool_dex": { "type": "string", "description": "DEX identifier of the pool" }, "block_number": { "type": "integer", "description": "Block number of the trade" }, "tx_hash": { "type": "string", "description": "Transaction hash" }, "tx_from_address": { "type": "string", "description": "Transaction sender address" }, "from_token_amount": { "type": "string", "description": "Amount of token sent" }, "to_token_amount": { "type": "string", "description": "Amount of token received" }, "price_from_in_currency_token": { "type": "string", "description": "Price of from-token in currency token" }, "price_to_in_currency_token": { "type": "string", "description": "Price of to-token in currency token" }, "price_from_in_usd": { "type": "string", "description": "Price of from-token in USD" }, "price_to_in_usd": { "type": "string", "description": "Price of to-token in USD" }, "block_timestamp": { "type": "string", "description": "Block timestamp" }, "kind": { "type": "string", "description": "Trade kind (buy or sell)" }, "volume_in_usd": { "type": "string", "description": "Trade volume in USD" }, "from_token_address": { "type": "string", "description": "From-token contract address" }, "to_token_address": { "type": "string", "description": "To-token contract address" } } } } } } } }, "CategoriesPools": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "type", "attributes", "relationships" ], "properties": { "id": { "type": "string", "description": "Pool identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "base_token_price_usd", "base_token_price_native_currency", "quote_token_price_usd", "quote_token_price_native_currency", "base_token_price_quote_token", "quote_token_price_base_token", "address", "name", "pool_created_at", "fdv_usd", "market_cap_usd", "price_change_percentage", "reserve_in_usd", "h24_volume_usd", "h24_tx_count" ], "properties": { "base_token_price_usd": { "type": "string", "description": "Base token price in USD" }, "base_token_price_native_currency": { "type": "string", "nullable": true, "description": "Base token price in native currency" }, "quote_token_price_usd": { "type": "string", "description": "Quote token price in USD" }, "quote_token_price_native_currency": { "type": "string", "nullable": true, "description": "Quote token price in native currency" }, "base_token_price_quote_token": { "type": "string", "nullable": true, "description": "Base token price in quote token" }, "quote_token_price_base_token": { "type": "string", "nullable": true, "description": "Quote token price in base token" }, "address": { "type": "string", "description": "Pool contract address" }, "name": { "type": "string", "description": "Pool name" }, "pool_created_at": { "type": "string", "description": "Pool creation timestamp" }, "fdv_usd": { "type": "string", "nullable": true, "description": "Fully diluted valuation in USD" }, "market_cap_usd": { "type": "string", "nullable": true, "description": "Market cap in USD" }, "price_change_percentage": { "type": "object", "description": "Price change percentage over various timeframes", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "reserve_in_usd": { "type": "string", "nullable": true, "description": "Total reserve in USD" }, "h24_volume_usd": { "type": "string", "description": "24hr volume in USD" }, "h24_tx_count": { "type": "integer", "description": "24hr transaction count" } } }, "relationships": { "type": "object", "description": "Related resources", "properties": { "base_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "quote_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "network": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "dex": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } } } } } } }, "included": { "type": "array", "description": "Included related resources, present when include parameter is specified", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "type": "object", "properties": { "address": { "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" }, "decimals": { "type": "integer" }, "image_url": { "type": "string", "nullable": true }, "coingecko_coin_id": { "type": "string", "nullable": true }, "coingecko_asset_platform_id": { "type": "string" } } } } } } } }, "OnchainCategoriesList": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "Category ID" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "name", "description", "volume_change_percentage", "reserve_in_usd", "fdv_usd", "h24_volume_usd", "h24_tx_count" ], "properties": { "name": { "type": "string", "description": "Category name" }, "description": { "type": "string", "description": "Category description" }, "volume_change_percentage": { "type": "object", "description": "Volume change percentage over various timeframes", "properties": { "h1": { "type": "string" }, "h6": { "type": "string" }, "h12": { "type": "string" }, "h24": { "type": "string" } } }, "reserve_in_usd": { "type": "string", "description": "Total reserve in USD" }, "fdv_usd": { "type": "string", "description": "Fully diluted valuation in USD" }, "h24_volume_usd": { "type": "string", "description": "24hr volume in USD" }, "h24_tx_count": { "type": "integer", "description": "24hr transaction count" } } } } } } } }, "Trades": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "Trade identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "block_number", "tx_hash", "tx_from_address", "from_token_amount", "to_token_amount", "price_from_in_currency_token", "price_to_in_currency_token", "price_from_in_usd", "price_to_in_usd", "block_timestamp", "kind", "volume_in_usd", "from_token_address", "to_token_address" ], "properties": { "block_number": { "type": "integer", "description": "Block number of the trade" }, "tx_hash": { "type": "string", "description": "Transaction hash" }, "tx_from_address": { "type": "string", "description": "Transaction sender address" }, "from_token_amount": { "type": "string", "description": "Amount of token sent" }, "to_token_amount": { "type": "string", "description": "Amount of token received" }, "price_from_in_currency_token": { "type": "string", "description": "Price of from-token in currency token" }, "price_to_in_currency_token": { "type": "string", "description": "Price of to-token in currency token" }, "price_from_in_usd": { "type": "string", "description": "Price of from-token in USD" }, "price_to_in_usd": { "type": "string", "description": "Price of to-token in USD" }, "block_timestamp": { "type": "string", "description": "Block timestamp" }, "kind": { "type": "string", "description": "Trade kind (buy or sell)" }, "volume_in_usd": { "type": "string", "description": "Trade volume in USD" }, "from_token_address": { "type": "string", "description": "From-token contract address" }, "to_token_address": { "type": "string", "description": "To-token contract address" } } } } } } } }, "OHLCV": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "Request ID" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "ohlcv_list" ], "properties": { "ohlcv_list": { "type": "array", "description": "OHLCV data as [timestamp, open, high, low, close, volume] arrays", "items": { "type": "array", "items": { "type": "number" } } } } } } }, "meta": { "type": "object", "properties": { "base": { "type": "object", "description": "Base token metadata", "properties": { "name": { "type": "string" }, "symbol": { "type": "string" }, "coingecko_coin_id": { "type": "string", "nullable": true }, "address": { "type": "string" } } }, "quote": { "type": "object", "description": "Quote token metadata", "properties": { "name": { "type": "string" }, "symbol": { "type": "string" }, "coingecko_coin_id": { "type": "string", "nullable": true }, "address": { "type": "string" } } } } } } }, "TokenInfoRecentlyUpdated": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "type", "attributes", "relationships" ], "properties": { "id": { "type": "string", "description": "Token identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "address", "name", "symbol", "decimals", "image_url", "coingecko_coin_id", "websites", "discord_url", "farcaster_url", "zora_url", "telegram_handle", "twitter_handle", "description", "gt_score", "metadata_updated_at" ], "properties": { "address": { "type": "string", "description": "Token contract address" }, "name": { "type": "string", "description": "Token name" }, "symbol": { "type": "string", "description": "Token symbol" }, "decimals": { "type": "integer", "description": "Token decimals" }, "image_url": { "type": "string", "nullable": true, "description": "Token image URL" }, "coingecko_coin_id": { "type": "string", "nullable": true, "description": "CoinGecko coin ID" }, "websites": { "type": "array", "description": "Token websites", "items": { "type": "string" } }, "discord_url": { "type": "string", "nullable": true, "description": "Discord URL" }, "farcaster_url": { "type": "string", "nullable": true, "description": "Farcaster URL" }, "zora_url": { "type": "string", "nullable": true, "description": "Zora URL" }, "telegram_handle": { "type": "string", "nullable": true, "description": "Telegram handle" }, "twitter_handle": { "type": "string", "nullable": true, "description": "Twitter handle" }, "description": { "type": "string", "nullable": true, "description": "Token description" }, "gt_score": { "type": "number", "nullable": true, "description": "GeckoTerminal trust score" }, "metadata_updated_at": { "type": "string", "description": "Metadata last updated timestamp" } } }, "relationships": { "type": "object", "properties": { "network": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } } } } } } }, "included": { "type": "array", "description": "Included network data, present when include=network is specified", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "type": "object", "properties": { "name": { "type": "string" }, "coingecko_asset_platform_id": { "type": "string" } } } } } } } }, "PoolTokensInfo": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/TokenInfoItem" }, { "type": "object", "required": [ "relationships" ], "properties": { "relationships": { "type": "object", "properties": { "pool": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } } } } } } ] } }, "included": { "type": "array", "description": "Included pool data, present when include=pool is specified", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "type": "object", "properties": { "base_token_address": { "type": "string", "description": "Base token contract address" }, "quote_token_address": { "type": "string", "description": "Quote token contract address" }, "quote_token_addresses": { "type": "array", "description": "Quote token contract addresses, present for pools with more than 2 tokens", "items": { "type": "string" } }, "sentiment_vote_positive_percentage": { "type": "number", "description": "GeckoTerminal community positive sentiment vote percentage" }, "sentiment_vote_negative_percentage": { "type": "number", "description": "GeckoTerminal community negative sentiment vote percentage" }, "community_sus_report": { "type": "integer", "description": "GeckoTerminal community suspicious reports count" } } } } } } } }, "TokenInfoItem": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "Token identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "address", "name", "symbol", "decimals", "image_url", "image", "coingecko_coin_id", "websites", "discord_url", "farcaster_url", "zora_url", "telegram_handle", "twitter_handle", "description", "gt_score", "gt_score_details", "gt_verified", "categories", "gt_category_ids", "holders", "mint_authority", "freeze_authority", "is_honeypot" ], "properties": { "address": { "type": "string", "description": "Token contract address" }, "name": { "type": "string", "description": "Token name" }, "symbol": { "type": "string", "description": "Token symbol" }, "decimals": { "type": "integer", "description": "Token decimals" }, "image_url": { "type": "string", "nullable": true, "description": "Token image URL" }, "image": { "type": "object", "description": "Token image URLs in different sizes", "properties": { "thumb": { "type": "string" }, "small": { "type": "string" }, "large": { "type": "string" } } }, "coingecko_coin_id": { "type": "string", "nullable": true, "description": "CoinGecko coin ID" }, "websites": { "type": "array", "description": "Token websites", "items": { "type": "string" } }, "discord_url": { "type": "string", "nullable": true, "description": "Discord URL" }, "farcaster_url": { "type": "string", "nullable": true, "description": "Farcaster URL" }, "zora_url": { "type": "string", "nullable": true, "description": "Zora URL" }, "telegram_handle": { "type": "string", "nullable": true, "description": "Telegram handle" }, "twitter_handle": { "type": "string", "nullable": true, "description": "Twitter handle" }, "description": { "type": "string", "nullable": true, "description": "Token description" }, "gt_score": { "type": "number", "description": "GeckoTerminal trust score" }, "gt_score_details": { "type": "object", "description": "GeckoTerminal trust score breakdown", "properties": { "pool": { "type": "number" }, "transaction": { "type": "number" }, "creation": { "type": "number" }, "info": { "type": "number" }, "holders": { "type": "number" } } }, "gt_verified": { "type": "boolean", "description": "Whether the token is verified on GeckoTerminal" }, "categories": { "type": "array", "description": "Token categories", "items": { "type": "string" } }, "gt_category_ids": { "type": "array", "description": "GeckoTerminal category IDs", "items": { "type": "string" } }, "holders": { "type": "object", "description": "Token holder information", "properties": { "count": { "type": "integer", "description": "Number of holders" }, "distribution_percentage": { "type": "object", "description": "Holder distribution percentage (keys vary by chain, e.g. top_10, 11_30, 31_50, rest)", "additionalProperties": { "type": "string" } }, "last_updated": { "type": "string", "description": "Last updated timestamp" } } }, "mint_authority": { "type": "string", "nullable": true, "description": "Mint authority status" }, "freeze_authority": { "type": "string", "nullable": true, "description": "Freeze authority status" }, "is_honeypot": { "oneOf": [ { "type": "boolean" }, { "type": "string" } ], "description": "Whether the token is a honeypot (boolean or 'unknown')" } } } } }, "TokenInfo": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/TokenInfoItem" } } }, "TokenItem": { "type": "object", "required": [ "id", "type", "attributes", "relationships" ], "properties": { "id": { "type": "string", "description": "Token identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "address", "name", "symbol", "decimals", "image_url", "coingecko_coin_id", "total_supply", "normalized_total_supply", "price_usd", "fdv_usd", "total_reserve_in_usd", "volume_usd", "market_cap_usd" ], "properties": { "address": { "type": "string", "description": "Token contract address" }, "name": { "type": "string", "description": "Token name" }, "symbol": { "type": "string", "description": "Token symbol" }, "decimals": { "type": "integer", "description": "Token decimals" }, "image_url": { "type": "string", "nullable": true, "description": "Token image URL" }, "coingecko_coin_id": { "type": "string", "nullable": true, "description": "CoinGecko coin ID" }, "total_supply": { "type": "string", "description": "Token total supply" }, "normalized_total_supply": { "type": "string", "description": "Normalized token total supply" }, "price_usd": { "type": "string", "nullable": true, "description": "Token price in USD" }, "fdv_usd": { "type": "string", "nullable": true, "description": "Fully diluted valuation in USD" }, "total_reserve_in_usd": { "type": "string", "description": "Total reserve in USD across all pools" }, "volume_usd": { "type": "object", "description": "Volume in USD", "properties": { "h24": { "type": "string" } } }, "market_cap_usd": { "type": "string", "nullable": true, "description": "Market cap in USD" }, "last_trade_timestamp": { "type": "string", "description": "Last trade timestamp in UNIX" }, "launchpad_details": { "type": "object", "description": "Launchpad details for pump-style tokens", "properties": { "graduation_percentage": { "type": "number" }, "completed": { "type": "boolean" }, "completed_at": { "type": "string", "nullable": true }, "migrated_destination_pool_address": { "type": "string", "nullable": true } } } } }, "relationships": { "type": "object", "properties": { "top_pools": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } } } } } } }, "MultiTokenData": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/TokenItem" } }, "included": { "type": "array", "description": "Included top pool data, present when include=top_pools is specified", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "type": "object", "properties": { "base_token_price_usd": { "type": "string" }, "base_token_price_native_currency": { "type": "string" }, "quote_token_price_usd": { "type": "string" }, "quote_token_price_native_currency": { "type": "string" }, "base_token_price_quote_token": { "type": "string" }, "quote_token_price_base_token": { "type": "string" }, "address": { "type": "string" }, "name": { "type": "string" }, "pool_created_at": { "type": "string" }, "fdv_usd": { "type": "string", "nullable": true }, "market_cap_usd": { "type": "string", "nullable": true }, "price_change_percentage": { "type": "object", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "transactions": { "type": "object", "properties": { "m5": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "m15": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "m30": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h1": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h6": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h24": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } } } }, "volume_usd": { "type": "object", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "reserve_in_usd": { "type": "string" } } }, "relationships": { "type": "object", "properties": { "base_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "quote_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "dex": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } } } } } } } } }, "TokenData": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/TokenItem" }, "included": { "type": "array", "description": "Included top pool data, present when include=top_pools is specified", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "type": "object", "properties": { "base_token_price_usd": { "type": "string" }, "base_token_price_native_currency": { "type": "string" }, "quote_token_price_usd": { "type": "string" }, "quote_token_price_native_currency": { "type": "string" }, "base_token_price_quote_token": { "type": "string" }, "quote_token_price_base_token": { "type": "string" }, "address": { "type": "string" }, "name": { "type": "string" }, "pool_created_at": { "type": "string" }, "token_price_usd": { "type": "string" }, "fdv_usd": { "type": "string", "nullable": true }, "market_cap_usd": { "type": "string", "nullable": true }, "price_change_percentage": { "type": "object", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "transactions": { "type": "object", "properties": { "m5": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "m15": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "m30": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h1": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h6": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h24": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } } } }, "volume_usd": { "type": "object", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "reserve_in_usd": { "type": "string" }, "last_trade_timestamp": { "type": "string" } } }, "relationships": { "type": "object", "properties": { "base_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "quote_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "dex": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } } } } } } } } }, "Pool": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "type", "attributes", "relationships" ], "properties": { "id": { "type": "string", "description": "Pool identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "base_token_price_usd", "base_token_price_native_currency", "quote_token_price_usd", "quote_token_price_native_currency", "base_token_price_quote_token", "quote_token_price_base_token", "address", "name", "pool_created_at", "fdv_usd", "market_cap_usd", "price_change_percentage", "transactions", "volume_usd", "reserve_in_usd" ], "properties": { "base_token_price_usd": { "type": "string", "description": "Base token price in USD" }, "base_token_price_native_currency": { "type": "string", "nullable": true, "description": "Base token price in native currency" }, "quote_token_price_usd": { "type": "string", "description": "Quote token price in USD" }, "quote_token_price_native_currency": { "type": "string", "nullable": true, "description": "Quote token price in native currency" }, "base_token_price_quote_token": { "type": "string", "nullable": true, "description": "Base token price in quote token" }, "quote_token_price_base_token": { "type": "string", "nullable": true, "description": "Quote token price in base token" }, "address": { "type": "string", "description": "Pool contract address" }, "name": { "type": "string", "description": "Pool name" }, "pool_created_at": { "type": "string", "description": "Pool creation timestamp" }, "fdv_usd": { "type": "string", "nullable": true, "description": "Fully diluted valuation in USD" }, "market_cap_usd": { "type": "string", "nullable": true, "description": "Market cap in USD" }, "price_change_percentage": { "type": "object", "description": "Price change percentage over various timeframes", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "transactions": { "type": "object", "description": "Transaction counts over various timeframes", "properties": { "m5": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "m15": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "m30": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h1": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h6": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h24": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } } } }, "volume_usd": { "type": "object", "description": "Volume in USD over various timeframes", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "reserve_in_usd": { "type": "string", "nullable": true, "description": "Total reserve in USD" }, "token_price_usd": { "type": "string", "description": "Price of the queried token in USD, present when querying pools by token address" }, "sentiment_vote_positive_percentage": { "type": "number", "description": "GeckoTerminal community positive sentiment vote percentage" }, "sentiment_vote_negative_percentage": { "type": "number", "description": "GeckoTerminal community negative sentiment vote percentage" }, "community_sus_report": { "type": "integer", "description": "GeckoTerminal community suspicious reports count" } } }, "relationships": { "type": "object", "description": "Related resources", "properties": { "base_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "quote_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "network": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "dex": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } } } } } } }, "included": { "type": "array", "description": "Included related resources, present when include parameter is specified", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "type": "object", "properties": { "address": { "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" }, "decimals": { "type": "integer" }, "image_url": { "type": "string", "nullable": true }, "coingecko_coin_id": { "type": "string", "nullable": true }, "coingecko_asset_platform_id": { "type": "string" } } } } } } } }, "PoolSearch": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "type", "attributes", "relationships" ], "properties": { "id": { "type": "string", "description": "Pool identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "base_token_price_usd", "base_token_price_native_currency", "quote_token_price_usd", "quote_token_price_native_currency", "base_token_price_quote_token", "quote_token_price_base_token", "address", "name", "pool_created_at", "fdv_usd", "market_cap_usd", "price_change_percentage", "transactions", "volume_usd", "reserve_in_usd" ], "properties": { "base_token_price_usd": { "type": "string", "description": "Base token price in USD" }, "base_token_price_native_currency": { "type": "string", "nullable": true, "description": "Base token price in native currency" }, "quote_token_price_usd": { "type": "string", "description": "Quote token price in USD" }, "quote_token_price_native_currency": { "type": "string", "nullable": true, "description": "Quote token price in native currency" }, "base_token_price_quote_token": { "type": "string", "nullable": true, "description": "Base token price in quote token" }, "quote_token_price_base_token": { "type": "string", "nullable": true, "description": "Quote token price in base token" }, "address": { "type": "string", "description": "Pool contract address" }, "name": { "type": "string", "description": "Pool name" }, "pool_created_at": { "type": "string", "description": "Pool creation timestamp" }, "fdv_usd": { "type": "string", "nullable": true, "description": "Fully diluted valuation in USD" }, "market_cap_usd": { "type": "string", "nullable": true, "description": "Market cap in USD" }, "price_change_percentage": { "type": "object", "description": "Price change percentage over various timeframes", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "transactions": { "type": "object", "description": "Transaction counts over various timeframes", "properties": { "m5": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "m15": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "m30": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h1": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h6": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } }, "h24": { "type": "object", "properties": { "buys": { "type": "integer" }, "sells": { "type": "integer" }, "buyers": { "type": "integer" }, "sellers": { "type": "integer" } } } } }, "volume_usd": { "type": "object", "description": "Volume in USD over various timeframes", "properties": { "m5": { "type": "string" }, "m15": { "type": "string" }, "m30": { "type": "string" }, "h1": { "type": "string" }, "h6": { "type": "string" }, "h24": { "type": "string" } } }, "reserve_in_usd": { "type": "string", "nullable": true, "description": "Total reserve in USD" } } }, "relationships": { "type": "object", "description": "Related resources", "properties": { "base_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "quote_token": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "network": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } }, "dex": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } } } } } } } } }, "included": { "type": "array", "description": "Included related resources, present when include parameter is specified", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "type": "object", "properties": { "address": { "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" }, "decimals": { "type": "integer" }, "image_url": { "type": "string", "nullable": true }, "coingecko_coin_id": { "type": "string", "nullable": true }, "coingecko_asset_platform_id": { "type": "string" } } } } } } } }, "OnchainSimplePrice": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "Request ID" }, "type": { "type": "string", "description": "Response type" }, "attributes": { "type": "object", "required": [ "token_prices" ], "properties": { "token_prices": { "type": "object", "description": "Token prices keyed by contract address", "additionalProperties": { "type": "string" } }, "market_cap_usd": { "type": "object", "description": "Market cap in USD keyed by contract address", "additionalProperties": { "type": "string" } }, "h24_volume_usd": { "type": "object", "description": "24hr volume in USD keyed by contract address", "additionalProperties": { "type": "string" } }, "h24_price_change_percentage": { "type": "object", "description": "24hr price change percentage keyed by contract address", "additionalProperties": { "type": "string" } }, "total_reserve_in_usd": { "type": "object", "description": "Total reserve in USD keyed by contract address", "additionalProperties": { "type": "string" } }, "last_trade_timestamp": { "type": "object", "description": "Last trade timestamp keyed by contract address", "additionalProperties": { "type": "string" } } } } } } } }, "DexesList": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "DEX identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "description": "DEX name" } } } } } } } }, "NetworksList": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "Network identifier" }, "type": { "type": "string", "description": "Resource type" }, "attributes": { "type": "object", "required": [ "name", "coingecko_asset_platform_id" ], "properties": { "name": { "type": "string", "description": "Network name" }, "coingecko_asset_platform_id": { "type": "string", "description": "Corresponding CoinGecko asset platform ID" } } } } } } } } } } }