pinion-price

Fetch current USD prices for Base tokens via Birdeye data sources.

95|6|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/chu2bard/pinion-os --skill pinion-price-chu2bard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pinion-price
Source: https://github.com/chu2bard/pinion-os/tree/main/skills/price
Command: npx skills add https://github.com/chu2bard/pinion-os --skill pinion-price-chu2bard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides real-time USD pricing for Base tokens with an integrated x402 payment flow, enabling on-demand price data without upfront costs.

Core Features & Use Cases

  • Real-time price, 24h change, and liquidity data for tokens on Base.
  • Supports token symbols (ETH, USDC, WETH, DAI, USDT, CBETH) or contract addresses.
  • Handles the paywall flow by returning price data after a signed USDC authorization and an X-PAYMENT header.
  • Use Case: traders and wallets can display accurate Base token values in dashboards or settlement logic.

Quick Start

Call the price endpoint after signing a USDC TransferWithAuthorization and retry with the X-PAYMENT header.

Frequently Asked Questions about pinion-price

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch real-time Base token prices using an API?

You fetch real-time Base token prices by querying an API endpoint that returns current USD price data, 24h change, and liquidity metrics sourced from Birdeye for specified token symbols or contract addresses.

How does the x402 payment protocol work for API price data?

The x402 payment protocol works by returning payment requirements from the API, then accepting an X-PAYMENT header after the client signs a USDC TransferWithAuthorization using EIP-3009 to validate the request.

Can I use a token symbol like ETH or do I need a contract address?

You can use either a token symbol or a contract address, as the API supports common Base token symbols like ETH, USDC, WETH, DAI, USDT, and CBETH alongside direct contract address queries.

Do I need to prepay for Base token price API calls?

No prepayment is needed for Base token price API calls, as the integrated x402 payment flow enables on-demand price data access by settling USDC payments per individual request.

What Base token data is included in the API response?

The API response includes real-time USD price, 24h change, and liquidity data for the queried Base token, providing accurate values for displaying in dashboards or settlement logic.