# 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"
```

**Response:**
```json
{
    "data": {
        "to": "usd",
        "from": "bitcoin",
        "rate": 62647,
        "amount": 2,
        "result": 125294,
        "source": "CoinGecko",
        "to_type": "currency"
    },
    "meta": {
        "timestamp": "2026-06-11T07:49:21.952Z",
        "request_id": "1cae5b8e-3bbe-4cd9-8694-56f5729f1683"
    },
    "status": "ok",
    "message": "Conversion computed",
    "success": true
}
```

#### `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"
```

**Response:**
```json
{
    "data": {
        "coins": {
            "bitcoin": {
                "eur": {
                    "price": 54253,
                    "market_cap": 1086986076732.9791,
                    "volume_24h": 26195920294.8621,
                    "change_24h_pct": 1.6583
                },
                "usd": {
                    "price": 62645,
                    "market_cap": 1255117906077.3877,
                    "volume_24h": 30247828681.557495,
                    "change_24h_pct": 1.595
                }
            },
            "ethereum": {
                "eur": {
                    "price": 1430.67,
                    "market_cap": 172664554048.31326,
                    "volume_24h": 10781948906.993124,
                    "change_24h_pct": 0.9071
                },
                "usd": {
                    "price": 1651.96,
                    "market_cap": 199371802610.6248,
                    "volume_24h": 12449669250.826027,
                    "change_24h_pct": 0.8443
                }
            }
        },
        "count": 2,
        "source": "CoinGecko",
        "vs_currencies": [
            "usd",
            "eur"
        ]
    },
    "meta": {
        "timestamp": "2026-06-11T07:49:22.204Z",
        "request_id": "d96d7505-c8e3-4ac8-a1a4-1e5b3109575c"
    },
    "status": "ok",
    "message": "Prices retrieved successfully",
    "success": true
}
```

#### `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"
```

**Response:**
```json
{
    "data": {
        "count": 63,
        "source": "CoinGecko",
        "currencies": [
            "aed",
            "ars",
            "aud",
            "bch",
            "bdt",
            "bhd",
            "bits",
            "bmd",
            "bnb",
            "brl",
            "btc",
            "cad",
            "chf",
            "clp",
            "cny",
            "czk",
            "dkk",
            "dot",
            "eos",
            "eth",
            "eur",
            "gbp",
            "gel",
            "hkd",
            "huf",
            "idr",
            "ils",
            "inr",
            "jpy",
            "krw",
            "kwd",
            "link",
            "lkr",
            "ltc",
            "mmk",
            "mxn",
            "myr",
            "ngn",
            "nok",
            "nzd",
            "php",
            "pkr",
            "pln",
            "rub",
            "sar",
            "sats",
            "sek",
            "sgd",
            "sol",
            "thb",
            "try",
            "twd",
            "uah",
            "usd",
            "vef",
            "vnd",
            "xag",
            "xau",
            "xdr",
            "xlm",
            "xrp",
            "yfi",
            "zar"
        ]
    },
    "meta": {
        "timestamp": "2026-06-11T07:49:22.303Z",
        "request_id": "77dfc5b8-7286-43a7-9e79-31cd53c29d24"
    },
    "status": "ok",
    "message": "Supported currencies retr
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Coin ids are lowercase CoinGecko ids (bitcoin, ethereum, solana). vs currencies are fiats or major coins (usd, eur, btc, eth). A 60s protective cache shields the shared upstream rate limit.",
        "source": "CoinGecko /simple/price + /simple/supported_vs_currencies (live, keyless)",
        "service": "cryptoconvert-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/price": "Live price of coins in currencies + market cap/volume/change (ids=bitcoin,ethereum&vs=usd,eur).",
            "GET /v1/convert": "Convert an amount of a coin to a fiat or another coin (from=bitcoin&to=usd&amount=2).",
            "GET /v1/supported": "Every currency you can quote or convert into."
        },
        "description": "Live crypto price and currency conversion from the public CoinGecko feed. A conversion utility, distinct from market-overview, arbitrage and coin-profile tools. The price endpoint returns the live price of one or more coins in one or more currencies with market cap, 24h volume and 24h change; the convert endpoint converts an amount of a coin into a fiat currency or another coin (2 BTC to EUR, or 1.5 BTC to ETH); the supported endpoint lists every currency you can quote or convert into. Live, no key.",
        "upstream_status": "ok",
        "supported_currencies": 63
    },
    "meta": {
        "timestamp": "2026-06-11T07:49:22.380Z",
        "request_id": "12278db5-9fd0-423c-b305-7a822b90d774"
 
…(truncated, see openapi.json for full schema)
```


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