--- name: pro-api.coingecko.com description: pro-api.coingecko.com provides on-chain USD spot price lookups for ERC-20 token contract addresses across multiple networks, primarily Base and Ethereum, with one Solana endpoint. All skills return current prices keyed by contract address; no historical, OHLCV, or off-chain aggregated data is available through these skills. host: pro-api.coingecko.com --- # pro-api.coingecko.com This host exposes CoinGecko's Pro API on-chain simple price endpoints. It serves agents that need current USD prices for specific token contract addresses on Base, Ethereum, or Solana. It is distinct from CoinGecko's off-chain aggregated coin price endpoints in that prices are sourced from on-chain data and queries are keyed by contract address rather than CoinGecko coin ID. ## When to use this host Use this host when an agent needs current on-chain USD spot prices for token contract addresses on Base, Ethereum, or Solana and has the contract/mint address available. The Base cluster is well-covered with both single and batch patterns. Do not use this host for: historical price data or OHLCV queries (no such skills exist here); off-chain or exchange-aggregated prices; tokens on networks other than Base, Ethereum, or Solana (e.g. BSC, Polygon, Arbitrum — use network-specific CoinGecko endpoints for those); or lookups by CoinGecko coin ID or ticker symbol rather than contract address. If you need aggregated market data, coin metadata, or trending lists, use CoinGecko's standard (non-onchain) Pro API endpoints instead. ## Capabilities ### Base Network Token Pricing Returns current USD spot prices for one or more ERC-20 token contract addresses deployed on the Base network. Multiple skills cover this same endpoint with minor input-parameter variations (contract_addresses vs token_addresses) and batch vs single-address patterns. - **`fetch-base-token-prices-batch`** — Returns USD prices for up to 12 Base network token contract addresses in a single GET request via the CoinGecko onchain simple price endpoint. - **`fetch-base-token-prices`** — Returns current USD prices for one or more token contract addresses on the Base network via CoinGecko's onchain simple price endpoint. - **`fetch-base-onchain-token-prices`** — Returns current USD prices for one or more token contract addresses on the Base network via CoinGecko's on-chain data. - **`fetch-base-token-price-onchain`** — Returns the current on-chain USD price for a specific ERC-20 token on the Base network via CoinGecko's pro API. ### Ethereum Network Token Pricing Returns current on-chain USD spot prices for ERC-20 token contract addresses on Ethereum mainnet, with inputs varying across skills (contract_address, addresses, token_address plus optional network parameter). - **`fetch-eth-onchain-token-price`** — Returns the current on-chain USD price for a specified ERC-20 token on Ethereum, keyed by contract address. - **`fetch-onchain-token-price-eth`** — Returns the real-time on-chain USD price for a given ERC-20 token address on the Ethereum network via CoinGecko's on-chain simple price endpoint. ### Solana Token Pricing Returns the current on-chain USD price for a Solana token mint address via CoinGecko's on-chain simple price endpoint. - **`fetch-solana-token-price-onchain`** — Returns the current on-chain USD price for a Solana token mint address via CoinGecko's on-chain simple price endpoint. ## Workflows ### Multi-Network Portfolio Valuation *Use when an agent needs to value a portfolio containing tokens spread across Base, Ethereum, and Solana simultaneously.* 1. **`fetch-base-token-prices-batch`** — Fetch current USD prices for all Base network token contract addresses in the portfolio in a single batched call. 2. **`fetch-eth-onchain-token-price`** — Fetch current USD prices for all Ethereum ERC-20 token contract addresses in the portfolio. 3. **`fetch-solana-token-price-onchain`** — Fetch the current USD price for the Solana token mint address in the portfolio, then aggregate all three results to compute total portfolio value. ## Skill reference ### `fetch-base-token-prices-batch` **Base Token Price Batch** — Returns USD prices for up to 12 Base network token contract addresses in a single GET request via the CoinGecko onchain simple price endpoint. *Use when:* Use when an agent needs current USD prices for one or more Base network ERC-20 token contracts in a single call, such as for portfolio valuation, trade sizing, or price display. *Not for:* Do not use for tokens on networks other than Base; use the appropriate network-specific CoinGecko onchain endpoint instead. Not suitable for streaming or real-time tick data. **Inputs:** - `contract_addresses` (string, required) — Comma-separated list of Base network token contract addresses to price. Embed directly in the URL path segment after /token_price/. **Returns:** Returns a JSON object with data.attributes.token_prices mapping each requested Base contract address to its current USD price as a decimal string, with all requested addresses present. **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x4200000000000000000000000000000000000006,0x940181a94a35a4569e4529a3cdfb74e38fd98631` --- ### `fetch-base-token-prices` **Base Token Price Lookup** — Returns current USD prices for one or more Base network token contracts via CoinGecko's onchain simple price endpoint. *Use when:* Use when an agent needs spot USD prices for specific Base network token contract addresses, such as before executing a swap, displaying portfolio value, or evaluating token exposure on Base. *Not for:* Do not use for tokens on other networks (e.g. Ethereum mainnet, Solana); use the appropriate network-specific CoinGecko endpoint instead. Not suitable for historical price data or OHLCV queries. **Inputs:** - `contract_addresses` (string, required) — Comma-separated list of Base network token contract addresses to price. Passed as the final path segment in the URL. **Returns:** Returns a data object with a token_prices map keyed by contract address, each value being the current USD price as a decimal string (e.g. WETH at 2129.29, AERO at 0.4248). **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x4200000000000000000000000000000000000006,0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf,0x940181a94a35a4569e4529a3cdfb74e38fd98631` --- ### `fetch-base-token-prices` **Base Token Price Lookup** — Returns current USD prices for one or more onchain token addresses on the Base network via CoinGecko's simple price endpoint. *Use when:* Use when an agent needs current USD spot prices for specific ERC-20 token contract addresses deployed on Base, such as before executing a swap, valuing a portfolio, or displaying token prices to a user. *Not for:* Do not use for tokens on other networks (e.g. Ethereum mainnet, Solana); use the corresponding network-specific CoinGecko endpoint instead. Not suitable for historical price data or OHLCV queries. **Inputs:** - `token_addresses` (string, required) — Comma-separated list of Base network ERC-20 token contract addresses to look up prices for. **Returns:** Returns a data object containing a token_prices map where each requested Base token address is keyed to its current USD price as a decimal string. **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x4200000000000000000000000000000000000006,0x940181a94a35a4569e4529a3cdfb74e38fd98631` --- ### `fetch-base-token-prices` **Base Token Price Lookup** — Returns current USD prices for one or more token contract addresses on the Base network via CoinGecko's onchain simple price endpoint. *Use when:* Use when an agent needs spot USD prices for specific ERC-20 token addresses deployed on Base, such as before executing a swap, valuing a portfolio, or displaying token prices to a user. *Not for:* Do not use for tokens on other networks (e.g. Ethereum mainnet, Solana); use the corresponding network-specific CoinGecko onchain price endpoint instead. Not suitable for historical price data. **Inputs:** - `token_addresses` (string, required) — Comma-separated list of token contract addresses on the Base network to look up prices for. **Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map of each requested Base token address to its current USD price as a decimal string. **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x940181a94a35a4569e4529a3cdfb74e38fd98631,0x4200000000000000000000000000000000000006,0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca` --- ### `fetch-base-token-prices` **Base Token Price Lookup** — Returns current USD prices for one or more ERC-20 token addresses on the Base network via CoinGecko's onchain simple price endpoint. *Use when:* Use when an agent needs spot USD prices for specific Base network token contract addresses, such as before executing a swap, displaying portfolio value, or evaluating token exposure. *Not for:* Do not use for tokens on other networks (e.g. Ethereum mainnet, Solana); use the corresponding network-specific CoinGecko endpoint instead. Not suitable for historical price data. **Inputs:** - `contract_addresses` (string, required) — Comma-separated list of Base network ERC-20 token contract addresses to look up prices for. **Returns:** Returns a data object with a token_prices map keyed by contract address, each value being the current USD price as a decimal string (e.g. WETH on Base = 2223.83 USD). **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x4200000000000000000000000000000000000006,0x940181a94a35a4569e4529a3cdfb74e38fd98631` --- ### `fetch-base-token-prices` **Base Token Price Lookup** — Returns live USD prices for one or more Base network token contract addresses via the CoinGecko onchain simple price endpoint. *Use when:* Use when an agent needs current USD prices for specific Base network token contracts identified by their on-chain addresses, such as before executing a swap or displaying portfolio valuations. *Not for:* Do not use for tokens on networks other than Base; use the appropriate network-specific CoinGecko onchain price endpoint instead. Not suitable for historical price data. **Inputs:** - `contract_addresses` (string, required) — Comma-separated list of Base network token contract addresses to price. Passed as a path segment in the URL. **Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map of each requested contract address to its current USD price as a decimal string. **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x4200000000000000000000000000000000000006,0x940181a94a35a4569e4529a3cdfb74e38fd98631,0x9b5e262cf9bb04869ab40b19af91d2dc85761722` --- ### `fetch-base-token-prices` **Base Token Price Lookup** — Returns current USD prices for one or more token contract addresses on the Base network via CoinGecko's onchain simple price endpoint. *Use when:* Use when an agent needs spot USD prices for specific Base network token addresses (e.g. WETH, cbBTC, AERO, USDbC) without requiring full market data or OHLCV history. *Not for:* Do not use for tokens on networks other than Base; use the appropriate network-specific CoinGecko onchain price endpoint instead. Not suitable for historical prices or OHLCV data. **Inputs:** - `token_addresses` (string, required) — Comma-separated list of Base network token contract addresses to price. Use the zero address (0x000...0000) for native ETH. **Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map of each requested Base address to its current USD price as a decimal string. **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x4200000000000000000000000000000000000006,0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf,0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca` --- ### `fetch-base-onchain-token-prices` **Base Token Price Feed** — Returns current USD prices for one or more Base network token addresses via CoinGecko on-chain simple price endpoint. *Use when:* Use when an agent needs current USD spot prices for specific ERC-20 token contract addresses on the Base network, such as before executing a trade, displaying portfolio value, or comparing token valuations. *Not for:* Do not use for tokens on networks other than Base; use the appropriate network-specific endpoint instead. Not suitable for historical price data or OHLCV data. **Inputs:** - `addresses` (string, required) — Comma-separated list of Base network token contract addresses to fetch prices for. **Returns:** Returns a data object with a token_prices map keyed by contract address, each value being the current USD price as a decimal string (e.g. WETH at 2171.7, AERO at 0.4168). **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x4200000000000000000000000000000000000006,0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b,0x940181a94a35a4569e4529a3cdfb74e38fd98631` --- ### `fetch-base-onchain-token-prices` **Base On-Chain Token Price** — Returns current USD prices for one or more token contract addresses on the Base network via CoinGecko's on-chain data. *Use when:* Use when an agent needs real-time USD prices for specific ERC-20 token contract addresses deployed on Base, such as before executing a swap or valuing a portfolio. *Not for:* Do not use for tokens on other networks (e.g. Ethereum mainnet, Solana); use the appropriate network-specific endpoint instead. Not suitable for historical price data. **Inputs:** - `contract_addresses` (string, required) — Comma-separated list of token contract addresses on the Base network to fetch prices for. **Returns:** Returns a data object with a token_prices map keyed by contract address, each value being the current USD price as a decimal string (e.g. WETH at 2328.1 USD). **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b,0x4200000000000000000000000000000000000006` --- ### `fetch-eth-onchain-token-price` **ETH On-Chain Token Price** — Returns the current on-chain USD price for a specified Ethereum ERC-20 token contract address via CoinGecko's Pro API. *Use when:* Use when an agent needs the current USD spot price of an Ethereum token identified by its contract address, such as before executing a trade or displaying a portfolio valuation. *Not for:* Do not use for tokens on non-Ethereum chains; use the equivalent network-specific endpoint instead. Not suitable for historical price lookups or OHLCV data. **Inputs:** - `contract_address` (string, required) — The Ethereum ERC-20 token contract address to price, embedded in the URL path. **Returns:** Returns a data object with type 'simple_token_price' and a token_prices map containing the contract address keyed to its current USD price as a decimal string. **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/eth/token_price/0x6982508145454Ce325dDbE47a25d4ec3d2311933` --- ### `fetch-solana-token-price-onchain` **SOL Token Price (On-Chain)** — Returns the current on-chain USD price for a Solana token mint address via CoinGecko's on-chain simple price endpoint. *Use when:* Use when an agent needs the current USD price of a specific Solana token identified by its mint address, sourced from on-chain data rather than exchange order books. *Not for:* Do not use for EVM or non-Solana token prices; use the appropriate network-specific endpoint instead. Not suitable for historical price data or OHLCV queries. **Returns:** Returns a data object with type 'simple_token_price' and a token_prices map containing the mint address keyed to its current USD price as a high-precision decimal string. **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/solana/token_price/So11111111111111111111111111111111111111112` --- ### `fetch-base-token-price-onchain` **Base On-Chain Token Price** — Returns the current on-chain USD price for a specific ERC-20 token on the Base network via CoinGecko's pro API. *Use when:* Use when an agent needs the live on-chain price of the ERC-20 token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC) on Base, for example to value a position, check a peg, or confirm a price before executing a trade. *Not for:* Do not use for off-chain CEX prices or prices on networks other than Base; use the appropriate CoinGecko network-specific endpoint instead. Not suitable for historical price lookups. **Returns:** Returns a data object with a token_prices map containing the on-chain USD price of the requested Base ERC-20 token as a decimal string (e.g. "1.00054967214595" for USDC). **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` --- ### `fetch-eth-onchain-token-price` **Ethereum On-Chain Token Price** — Returns the current on-chain USD price for a specified ERC-20 token on Ethereum, keyed by contract address. *Use when:* Use when an agent needs the current on-chain USD price of an ERC-20 token on Ethereum and has the token's contract address available. *Not for:* Do not use for tokens on other networks (e.g., BSC, Polygon, Arbitrum); use the appropriate network-specific endpoint instead. Not suitable for historical price lookups. **Inputs:** - `network` (string, required) — The blockchain network identifier, fixed to 'eth' for this endpoint. - `addresses` (string, required) — The ERC-20 token contract address on Ethereum to look up the price for. **Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map from the contract address to its current on-chain USD price as a decimal string. **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/eth/token_price/0xdac17f958d2ee523a2206206994597c13d831ec7` --- ### `fetch-onchain-token-price-eth` **WETH On-Chain Price (Ethereum)** — Returns the real-time on-chain USD price for a specific ERC-20 token on Ethereum via CoinGecko Pro, keyed by contract address. *Use when:* Use when an agent needs the current on-chain USD price of WETH or another Ethereum token by contract address, without relying on CoinGecko's off-chain aggregated price feed. *Not for:* Do not use for tokens on other networks (e.g., Base, Arbitrum, Polygon); use the equivalent network-specific endpoint instead. Not suitable for historical price lookups. **Inputs:** - `network` (string, required) — The blockchain network identifier used in the URL path. For Ethereum mainnet use 'eth'. - `token_address` (string, required) — The ERC-20 contract address of the token to price, used in the URL path. **Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map containing the contract address keyed to its current USD price string (e.g., "2360.55154024358"). **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/eth/token_price/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2` --- ### `fetch-onchain-token-price-eth` **Ethereum On-Chain Token Price (CoinGecko)** — Returns the real-time on-chain USD price for a given ERC-20 token address on the Ethereum network via CoinGecko's on-chain simple price endpoint. *Use when:* Use when an agent needs the current on-chain USD price of a specific ERC-20 token on Ethereum, identified by its contract address, without requiring off-chain or aggregated pricing data. *Not for:* Do not use for tokens on networks other than Ethereum; use the equivalent endpoint for the target network instead. Not suitable for historical price lookups or OHLCV data. **Inputs:** - `network` (string, required) — The blockchain network identifier. For this endpoint the value is fixed to 'eth' (Ethereum mainnet). - `addresses` (string, required) — Comma-separated ERC-20 token contract address(es) to price. Passed as the final path segment or query parameter depending on endpoint variant. **Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map containing the queried contract address and its current USD price as a decimal string. **Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/eth/token_price/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48` ---