如何使用 API 获取 Arc Chain 代币价格和市场数据

Circle, the company behind USDC, launched Arc, a Layer-1 blockchain built for stablecoin finance. Developers now need a reliable way to access Arc token prices, market caps, and liquidity data programmatically.

This guide shows you how to use the CoinGecko and GeckoTerminal APIs to retrieve price and market data for any token deployed on Arc, whether it is a stablecoin, DeFi token, or future native network asset.

Note: CoinGecko has unified its API with the GeckoTerminal API, so standard market data and onchain DEX data are now accessible through a single CoinGecko API key. You don't need a separate account or API key.

Prerequisites

You'll need a CoinGecko API key. If you don't have one, follow the guide to get a free Demo API key. The Demo plan provides everything you need to follow this guide and run the examples.

Your API key type must match the base URL and authentication header used in your requests. All examples in this guide use the Demo configuration. For paid plans, use the Paid configuration instead.

Key type Base URL Header Demo https://api.coingecko.com/api/v3 x-cg-demo-api-key Paid https://pro-api.coingecko.com/api/v3 x-cg-pro-api-key

To run the full script included at the end of this guide, you'll need Python 3.8+. Install the official SDK and requests :

pip install coingecko-sdk requests

💡 Prefer less setup? You can call these endpoints with CoinGecko's official Python SDK or TypeScript SDK instead of raw HTTP requests. The SDK handles the base URL, headers, and authentication for you, so there is less boilerplate to write.

How to Identify a Token on Arc Chain by Contract Address

CoinGecko API and GeckoTerminal API provide two ways to look up a token on Arc Chain by contract address. Both calls use Circle Wrapped BTC (cirBTC) as the example token.

Coin Data by Token Address

/coins/{asset_platform_id}/contract/{contract_address} returns full metadata once a token has been reviewed and listed.

curl --request GET \

--url 'https://api.coingecko.com/api/v3/coins/arc/contract/0x171a4217b86a807a64eb94757db6849fb4bdbaa0' \

--header 'x-cg-demo-api-key: '

Here’s what the response looks like:

{ "id": "circle-wrapped-btc", "symbol": "cirbtc", "name": "Circle Wrapped BTC", "asset_platform_id": "ethereum", "platforms": { "arc": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0", "ethereum": "0x72dfb2e44f59c5ad2bafe84314e5b99a7cd5075e" }

Token Data by Token Address

/onchain/networks/{network}/tokens/{address} automatically indexes tokens once they have an active liquidity pool.

curl --request GET \

--url 'https://api.coingecko.com/api/v3/onchain/networks/arc/tokens/0x171a4217b86a807a64eb94757db6849fb4bdbaa0' \

--header 'x-cg-demo-api-key: '

Here’s what the response looks like:

{ "data": { "id": "arc_0x171a4217b86a807a64eb94757db6849fb4bdbaa0", "type": "token", "attributes": { "address": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0", "name": "Circle Wrapped BTC", "symbol": "cirbtc", "decimals": 8, "coingecko_coin_id": "circle-wrapped-btc", "price_usd": "75748.9838130729", "fdv_usd": "9156840.63875057", "market_cap_usd": null } } }

How to Get a Coin's ID and Metadata on Arc Chain

The token's id comes from the Coin Data by Token Address response in the previous section. In this example, the id is circle-wrapped-btc . This id is used with other endpoints that require a coin ID. The contract address should not be used in place of the id , and the id should be resolved from the contract address rather than hardcoded.

Coin Data by ID

/coins/{id} returns the token's metadata, including the platforms field, which lists the chains where the token is deployed. USDC, which is used to pay gas fees on Arc is deployed on 30+ chains:

curl --request GET \

--url 'https://api.coingecko.com/api/v3/coins/usd-coin?localization=false&market_data=false&tickers=false' \

--header 'x-cg-demo-api-key: '

The API returns the following:

{ "id": "usd-coin", "symbol": "usdc", "name": "USDC", "platforms": { "ethereum": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "base": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "solana": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "arc": "0x3600000000000000000000000000000000000000" } }

Token Info by Token Address

/onchain/networks/{network}/tokens/{address}/info provides an independent way to verify whether a token has been reviewed and listed on CoinGecko using its contract address.

It also includes the image object (logo thumbnails), description , websites , social links, categories , and holder distribution, providing the metadata needed to build a fuller token profile beyond price and market data.

curl --request GET \

--url 'https://api.coingecko.com/api/v3/onchain/networks/arc/tokens/0x171a4217b86a807a64eb94757db6849fb4bdbaa0/info' \