---
name: pro-api.coingecko.com
description: pro-api.coingecko.com provides on-chain spot USD price lookups for ERC-20 token contract addresses across the Base network and Ethereum mainnet, plus Solana token mint addresses, via CoinGecko's Pro API. All skills return current token prices only; no historical data, OHLCV, or order book data is available. The host exposes multiple overlapping skill variants that resolve to the same underlying CoinGecko onchain simple price endpoint.
host: pro-api.coingecko.com
---

# pro-api.coingecko.com

This host is a narrow, network-specific on-chain price feed backed by CoinGecko Pro. It serves agents that need current USD spot prices for tokens identified by contract address on Base, Ethereum, or Solana. It does not provide aggregated market data, exchange prices, historical candles, or coverage of other EVM chains such as Polygon, Arbitrum, or BSC. The skill set is heavily redundant: roughly 15 of the 24 skills resolve to the same Base network price endpoint with minor input-naming differences.

## When to use this host

Use this host when an agent needs current on-chain USD spot prices for tokens on Base or Ethereum identified by contract address, or for Solana tokens identified by mint address, and has a CoinGecko Pro API key. Do not use this host for: historical price data or OHLCV candles (no such skills exist here); tokens on Polygon, Arbitrum, BSC, or other EVM chains not covered; CEX or aggregated off-chain prices; streaming or tick-by-tick price feeds; or any market metadata beyond price. For historical or broader market data, use CoinGecko's standard market data endpoints or a dedicated OHLCV provider. For multi-chain coverage beyond Base and Ethereum, a different host or a more general CoinGecko endpoint is required.

## Capabilities

### Base Network Token Pricing

Fetches current on-chain USD spot prices for one or more ERC-20 token contract addresses deployed on the Base network. Multiple skill variants exist with minor input-naming differences but identical outputs.

- **`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`** — Returns the current on-chain USD price for a specific ERC-20 token contract address on the Base network via CoinGecko's onchain API.
- **`fetch-base-token-price-onchain`** — Returns the current on-chain USD price for a token on the Base network by contract address, sourced from CoinGecko Pro.
- **`fetch-base-onchain-token-price`** — Returns the current on-chain USD price for a token by contract address on the Coinbase Base network via CoinGecko's pro API.

### Ethereum Network Token Pricing

Fetches current on-chain USD spot prices for ERC-20 token contract addresses on Ethereum mainnet via CoinGecko Pro.

- **`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

Fetches the current on-chain USD price for a Solana token identified by its mint address via CoinGecko's onchain 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

### Cross-Network Portfolio Valuation

*Use when an agent needs to value a portfolio containing tokens across both Base and Ethereum in a single pass.*

1. **`fetch-base-token-prices-batch`** — Fetch current USD prices for all Base network token contract addresses in the portfolio.
2. **`fetch-eth-onchain-token-price`** — Fetch current USD prices for all Ethereum mainnet token contract addresses in the portfolio, then combine results with Base prices 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-token-price`

**CoinGecko Base Token Price** — Returns the current USD price for a specified ERC-20 token on the Base network via CoinGecko's onchain pricing API.

*Use when:* Use when an agent needs the latest USD-denominated spot price for a token deployed on the Base network, identified by its contract address.

*Not for:* Do not use for tokens on other networks (e.g., Ethereum mainnet, Solana); use the appropriate network-specific CoinGecko onchain price endpoint instead. Not suitable for historical price data.

**Inputs:**

- `token_address` (string, required) — The ERC-20 contract address of the token on the Base network to retrieve the price for.

**Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map from the token 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/0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b`

---

### `fetch-base-token-price`

**CoinGecko Base Token Price** — Returns the current onchain price (in USD) for a specified ERC-20 token on the Base network via CoinGecko's onchain pricing data.

*Use when:* Use when an agent needs the current USD price of a specific token deployed on the Base network, identified by its contract address.

*Not for:* Do not use for tokens on other EVM chains (e.g., Ethereum mainnet, Polygon); use the corresponding network-specific endpoint instead. Not suitable for historical price data or OHLCV queries.

**Inputs:**

- `token_address` (string, required) — The ERC-20 contract address of the token on the Base network, embedded in the URL path.

**Returns:** Returns a data object with a token_prices map containing the queried Base-chain contract address as key and its current USD price as a decimal string value.

**Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x940181a94A35A4569E4529A3CDfB74e38FD98631`

---

### `fetch-base-token-price`

**CoinGecko Base Token Price** — Returns the current onchain price in USD for a specified ERC-20 token contract address on the Base network via CoinGecko's onchain pricing API.

*Use when:* Use when an agent needs the current USD price of a token deployed on the Base network and has the token's contract address available.

*Not for:* Do not use for tokens on other networks (e.g. Ethereum mainnet, Solana); use the appropriate network-specific CoinGecko onchain price endpoint instead. Not suitable for historical price data.

**Inputs:**

- `contract_address` (string, required) — ERC-20 token contract address on the Base network to retrieve the price for. Encoded in the URL path.

**Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map from the 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/0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed`

---

### `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-base-token-price-onchain`

**Base Onchain Token Price** — Returns the current on-chain USD price for a specific token on the Base network, identified by its contract address, via CoinGecko Pro.

*Use when:* Use when an agent needs the current on-chain USD price of a token deployed on the Base network and has the token's contract address available.

*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 queries.

**Inputs:**

- `token_address` (string, required) — The contract address of the token on the Base network whose price is being requested. Encoded in the URL path.

**Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map containing the queried contract address mapped 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`

---

### `fetch-base-onchain-token-price`

**Base On-Chain Token Price** — Returns the current on-chain USD price for a token on the Base network, looked up by contract address via CoinGecko's on-chain API.

*Use when:* Use when an agent needs the real-time on-chain price of a specific Base network token and has its contract address available.

*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 queries.

**Inputs:**

- `contract_address` (string, required) — The Base network contract address of the token to price, embedded 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 as a decimal string.

**Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf`

---

### `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-base-token-price-onchain`

**Base On-Chain Token Price** — Returns the current on-chain USD price for a specified ERC-20 token contract address on the Base network via CoinGecko.

*Use when:* Use when an agent needs the real-time on-chain USD price of a token deployed on the Base network, identified by its contract address.

*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_address` (string, required) — The ERC-20 token contract address on the Base network to fetch the USD price for.

**Returns:** Returns a data object with id, type='simple_token_price', and attributes.token_prices mapping 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/base/token_price/0x00dde4d2f08497bcec6f5e0666f63e14b3a1dab9`

---

### `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`

---

### `fetch-base-onchain-token-price`

**Base On-Chain Token Price** — Returns the current on-chain USD price for a token by contract address on the Coinbase Base network via CoinGecko's pro API.

*Use when:* Use when an agent needs the real-time on-chain USD price of a specific ERC-20 token deployed on the Base network, identified by its contract address.

*Not for:* Do not use for tokens on other EVM networks (e.g. Ethereum mainnet, Polygon); use the corresponding network-specific endpoint instead. Not suitable for historical price data.

**Inputs:**

- `contract_address` (string, required) — The ERC-20 token contract address on the Base network to fetch the price for. Supplied as a path parameter in the URL.

**Returns:** Returns a data object with a UUID id, type 'simple_token_price', and an attributes.token_prices map containing the contract address keyed to its current on-chain USD price as a high-precision decimal string.

**Example:** `GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x00e57ec29ef2ba7df07ad10573011647b2366f6d`

---

### `fetch-base-token-price-onchain`

**On-Chain Base Token Price** — Returns the current on-chain USD price for a token on the Base network by contract address, sourced from CoinGecko Pro.

*Use when:* Use when an agent needs the real-time on-chain USD price of a specific token deployed on the Base network, identified by its contract address.

*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_address` (string, required) — The contract address of the token on the Base network whose price is being queried. Embedded in the URL path.

**Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map from the 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/0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b`

---

### `fetch-base-token-price`

**Base Token Price Lookup** — Returns the current on-chain USD price for a specific ERC-20 token contract address on the Base network via CoinGecko's onchain API.

*Use when:* Use when an agent needs the current USD price of a token on the Base network and has the token's contract address available.

*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 or OHLCV queries.

**Inputs:**

- `contract_address` (string, required) — The ERC-20 token contract address on the Base network to look up the price for. Provided as a path parameter in the URL.

**Returns:** Returns a data object with type 'simple_token_price' and an attributes.token_prices map from the 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/0x008b2c67fe2e1a7a28105bd5e7d9760915907dbb`

---
