# Crypto Price & Converter API
> Live crypto price and currency conversion, served from the public CoinGecko feed with no key and nothing cached. This is a conversion utility, distinct from market-overview, arbitrage and coin-profile tools: it tells you what a coin is worth right now and converts an amount between coins and fiats. The price endpoint returns the live price of one or more coins in one or more currencies at once, each with its market cap, 24-hour volume and 24-hour change — pull Bitcoin and Ethereum in USD, EUR and BTC in a single call. The convert endpoint converts an amount of a coin into a fiat currency or into another coin: two Bitcoin to euros, or one and a half Bitcoin to Ether, with the rate and the result. Coin-to-coin conversions are crossed through USD automatically. The supported endpoint lists every currency you can quote or convert into — dozens of fiats plus the major coins. Everything is read live from CoinGecko on each request, nothing stored beyond a short protective cache. Ideal for wallets, checkout and payment flows, portfolio trackers, price tickers and dashboards. Coin ids are lowercase CoinGecko ids (bitcoin, ethereum, solana). Live, no key. 3 endpoints. For prices by on-chain contract address use a token-price API.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/cryptoconvert-api/..."
```

## Pricing
- **Free** (Free) — 6,000 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 110,000 calls/Mo, 6 req/s
- **Pro** ($22/Mo) — 600,000 calls/Mo, 18 req/s
- **Business** ($50/Mo) — 3,600,000 calls/Mo, 45 req/s

## Endpoints

### Convert

#### `GET /v1/convert` — Convert an amount of a coin to a fiat or coin

**Parameters:**
- `from` (query, required, string) — Coin id to convert from Example: `bitcoin`
- `to` (query, required, string) — Fiat currency or coin id to convert to Example: `usd`
- `amount` (query, optional, string) — Amount to convert (default 1) Example: `2`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptoconvert-api/v1/convert?from=bitcoin&to=usd&amount=2"
```

#### `GET /v1/price` — Live price of coins in currencies

**Parameters:**
- `ids` (query, required, string) — Coin ids (lowercase CoinGecko ids), comma-separated Example: `bitcoin,ethereum`
- `vs` (query, optional, string) — Quote currencies, comma-separated (default usd) Example: `usd,eur`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptoconvert-api/v1/price?ids=bitcoin%2Cethereum&vs=usd%2Ceur"
```

#### `GET /v1/supported` — Every currency you can quote or convert into

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptoconvert-api/v1/supported"
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptoconvert-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/cryptoconvert-api
OpenAPI spec: https://www.oanor.com/api/cryptoconvert-api/openapi.json