Token Price

Returns the current USD price, 24h change, and liquidity for a token on Base.

Endpoint

GET https://pinionos.com/skill/price/:token

Price: $0.01 USDC per call (x402 on Base)

Parameters

Parameter	Type	Required	Description
token	string	yes	Token symbol (ETH, USDC, WETH, DAI, USDT, CBETH) or any Base contract address (0x...)

Example Request (by symbol)

curl https://pinionos.com/skill/price/ETH

Example Request (by contract address)

curl https://pinionos.com/skill/price/0x4200000000000000000000000000000000000006

The first request returns HTTP 402 with payment requirements. Sign a USDC TransferWithAuthorization (EIP-3009) and retry with the X-PAYMENT header.

Example Response

{
  "token": "ETH",
  "network": "base",
  "priceUSD": 2650.42,
  "change24h": "-1.23%",
  "liquidity": 10854103.38,
  "source": "birdeye",
  "timestamp": "2026-02-17T12:00:00.000Z"
}

Supported Tokens

By symbol: ETH, USDC, WETH, DAI, USDT, CBETH

By address: Any Base mainnet token contract address (0x + 40 hex chars).

Data Sources

• Primary: Birdeye -- real-time DEX prices with liquidity data, 300 req/sec
• Fallback: CoinGecko -- used if Birdeye is unavailable or BIRDEYE_API_KEY is not set

When to Use

• Get the current price before constructing a trade.
• Display token values in USD.
• Monitor price movements for an agent's portfolio.
• Look up the price of any Base token by contract address.