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, "number_of_unique_addresses_24h_percentage_change": -0.01932, "volume_in_usd_24h_percentage_change": -41.58861, "total_supply": 8888, "one_day_sales": 6, "one_day_sales_24h_percentage_change": -40, "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": "
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, "number_of_unique_addresses_24h_percentage_change": -0.01932, "volume_in_usd_24h_percentage_change": -41.58861, "total_supply": 8888, "one_day_sales": 6, "one_day_sales_24h_percentage_change": -40, "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": "
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, "usd": 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, "native_currency": -100 }, "number_of_unique_addresses": 100, "number_of_unique_addresses_24h_percentage_change": 0, "volume_in_usd_24h_percentage_change": -100, "total_supply": 9994, "one_day_sales": null, "one_day_sales_24h_percentage_change": 0, "one_day_average_sale_price": null, "one_day_average_sale_price_24h_percentage_change": 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": "
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, "number_of_unique_addresses_24h_percentage_change": -0.05304, "volume_in_usd_24h_percentage_change": 10.0902, "total_supply": 9998, "one_day_sales": 18, "one_day_sales_24h_percentage_change": 50, "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, "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, "type": "crypto" }, "sats": { "name": "Satoshi", "unit": "sats", "value": 100000000, "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": 0.000005938674704566297, "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" ] } ] } } } } } }, "/insights": { "get": { "summary": "Coin Insights", "description": "To query the latest coin insights on CoinGecko", "operationId": "insights", "x-mint": { "href": "/reference/insights" }, "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 insights by coin ID. \n*refers to [`/coins/list`](/reference/coins-list).", "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "description": "Starting date in ISO date string (`YYYY-MM-DD`).", "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": false, "description": "Ending date in ISO date string (`YYYY-MM-DD`).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "List of latest coin insights", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Insights" }, "example": [ { "title": "Solana Experiences Surge in Memecoin Launches and Impersonation Scams", "description": "Solana's network is seeing a rise in memecoin launches and rapid pumps. However, this speculative activity is accompanied by impersonation scams, posing risks to the ecosystem.", "related_coin_ids": [ "wrapped-solana" ], "posted_at": "2026-06-15T03:56:19.514666Z" }, { "title": "Solana Sees Rising Tokenized Asset Volumes and Institutional RWA Products", "description": "Blockworks data indicates growing tokenized-asset volumes on Solana across various categories. Institutional products, like OnRe's dollar/reinsurance-backed offering, are emerging, increasing RWA activity.", "related_coin_ids": [ "wrapped-solana" ], "posted_at": "2026-06-15T03:56:19.486886Z" } ] } } } } } }, "/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": "holder_count_min", "in": "query", "required": false, "description": "Minimum holder count.", "schema": { "type": "integer" } }, { "name": "holder_count_max", "in": "query", "required": false, "description": "Maximum holder count.", "schema": { "type": "integer" } }, { "name": "top_10_holders_percentage_min", "in": "query", "required": false, "description": "Minimum top 10 holders percentage.", "schema": { "type": "number" } }, { "name": "top_10_holders_percentage_max", "in": "query", "required": false, "description": "Maximum top 10 holders 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" }, "banner_image_url": "https://assets.geckoterminal.com/kn680ou6904r03syp0ecu52ihy9c", "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, "info": 100, "holders": 100 }, "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", "developer_address": "4t7dHZcUzNC96d79won5TRZsvwP1bumhPNf3awR5BHdu", "developer_holding_percentage": "0.0" } } } } } } } } }, "/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", "banner_image_url": null, "coingecko_coin_id": "wrapped-solana", "gt_score": 88.9908256880734, "gt_verified": true, "mint_authority": "no", "freeze_authority": "no", "is_honeypot": "unknown", "developer_address": null, "developer_holding_percentage": null }, "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", "banner_image_url": "https://assets.geckoterminal.com/kn680ou6904r03syp0ecu52ihy9c", "coingecko_coin_id": "pippin", "gt_score": 86.54440366972477, "gt_verified": true, "mint_authority": "no", "freeze_authority": "no", "is_honeypot": "unknown", "developer_address": "4t7dHZcUzNC96d79won5TRZsvwP1bumhPNf3awR5BHdu", "developer_holding_percentage": "0.0" }, "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", "token_balance_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", "description": "Learn how to [set up your API key](https://docs.coingecko.com/docs/setting-up-your-api-key)" }, "queryAuth": { "type": "apiKey", "in": "query", "name": "x_cg_pro_api_key", "description": "Learn how to [set up your API key](https://docs.coingecko.com/docs/setting-up-your-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", "has_supply_breakdown", "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" } }, "has_supply_breakdown": { "type": "boolean", "description": "Whether detailed supply breakdown data is available via /coins/supply_breakdown" }, "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", "has_supply_breakdown", "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" } }, "has_supply_breakdown": { "type": "boolean", "description": "Whether detailed supply breakdown data is available via /coins/supply_breakdown" }, "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", "banner_image_url", "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", "developer_address", "developer_holding_percentage" ], "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" } } }, "banner_image_url": { "type": "string", "nullable": true, "description": "Token banner 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", "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')" }, "developer_address": { "type": "string", "nullable": true, "description": "Developer wallet address" }, "developer_holding_percentage": { "type": "string", "nullable": true, "description": "Developer holding as a percentage of total supply" } } } } }, "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" } } } } } } } }, "CoinSupplyBreakdown": { "type": "object", "required": [ "id", "symbol", "name", "supply_data", "non_circulating_wallets" ], "properties": { "id": { "type": "string", "description": "Coin ID" }, "symbol": { "type": "string", "description": "Coin symbol" }, "name": { "type": "string", "description": "Coin name" }, "supply_data": { "type": "object", "description": "Supply data", "properties": { "total_supply": { "type": "number", "description": "Total supply" }, "circulating_supply": { "type": "number", "description": "Circulating supply" }, "outstanding_supply": { "type": "number", "description": "Outstanding supply" }, "non_circulating_supply": { "type": "number", "description": "Non-circulating supply" }, "last_updated": { "type": "string", "description": "Last updated timestamp in ISO 8601 format" } } }, "non_circulating_wallets": { "type": "array", "description": "List of non-circulating wallets", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Wallet address" }, "label": { "type": "string", "description": "Wallet label" }, "balance": { "type": "number", "description": "Wallet balance" }, "percentage_of_total_supply": { "type": "number", "description": "Percentage of total supply held by this wallet" }, "anomaly": { "type": "boolean", "description": "Indicates an unreliable balance update; when true, circulating supply falls back to the last known-good balance" }, "last_updated": { "type": "string", "description": "Last updated timestamp in ISO 8601 format" } } } } } }, "Insights": { "type": "array", "items": { "type": "object", "required": [ "title", "description", "related_coin_ids", "posted_at" ], "properties": { "title": { "type": "string", "description": "Insight title" }, "description": { "type": "string", "description": "Insight description" }, "related_coin_ids": { "type": "array", "items": { "type": "string" }, "description": "Related coin IDs" }, "posted_at": { "type": "string", "description": "Insight posted timestamp in ISO 8601 format" } } } } } } }