# Pinion Price

> Get current USD price for any token on Base via Birdeye (CoinGecko fallback). Costs $0.01 USDC via x402.

- **Type:** Skill
- **Install:** `agentstack add skill-chu2bard-pinion-os-price`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [chu2bard](https://agentstack.voostack.com/s/chu2bard)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [chu2bard](https://github.com/chu2bard)
- **Source:** https://github.com/chu2bard/pinion-os/tree/main/skills/price

## Install

```sh
agentstack add skill-chu2bard-pinion-os-price
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

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

## Example Request (by contract address)

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

```json
{
  "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](https://birdeye.so) -- 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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [chu2bard](https://github.com/chu2bard)
- **Source:** [chu2bard/pinion-os](https://github.com/chu2bard/pinion-os)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-chu2bard-pinion-os-price
- Seller: https://agentstack.voostack.com/s/chu2bard
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.