# RedStone Oracle Prices API
> Live oracle price feeds for over a thousand assets across every asset class in a single source — cryptocurrencies, US equities and ETFs, precious metals and commodities, fiat currencies and liquid-staking and real-world-asset tokens — served from the public RedStone oracle, no key, nothing stored. RedStone is the decentralized oracle that DeFi protocols read on-chain for their prices, so this is the cross-asset reference-price layer: the same feed gives you Bitcoin, Apple, gold, the euro and wstETH side by side, each stamped with the time the oracle signed it. The price endpoint returns one asset's latest oracle value. The prices endpoint returns many assets in one call — mix crypto, stocks, metals, FX and staking tokens freely. The symbols endpoint lists and searches every supported asset, from majors to obscure liquid-staking and tokenized real-world assets you will not find in a normal price feed. This is the multi-asset oracle-price cut — one feed for every class — distinct from the single-asset-class price, converter and precious-metals APIs in the catalogue.

## 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/redstone-api/..."
```

## Pricing
- **Free** (Free) — 17,000 calls/Mo, 3 req/s
- **Builder** ($9/Mo) — 200,000 calls/Mo, 10 req/s
- **Pro** ($26/Mo) — 820,000 calls/Mo, 28 req/s
- **Scale** ($61/Mo) — 2,900,000 calls/Mo, 65 req/s

## Endpoints

### Price

#### `GET /v1/price` — One asset latest oracle price

**Parameters:**
- `symbol` (query, required, string) — Asset symbol Example: `BTC`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/redstone-api/v1/price?symbol=BTC"
```

### Prices

#### `GET /v1/prices` — Many assets in one call (any class)

**Parameters:**
- `symbols` (query, required, string) — Comma-separated symbols Example: `BTC,ETH,AAPL,XAU,EUR`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/redstone-api/v1/prices?symbols=BTC%2CETH%2CAAPL%2CXAU%2CEUR"
```

### Symbols

#### `GET /v1/symbols` — List or search supported assets

**Parameters:**
- `search` (query, optional, string) — Filter by substring Example: `eth`
- `limit` (query, optional, string) — Max results (1-1500) Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/redstone-api/v1/symbols?search=eth&limit=100"
```

### Meta

#### `GET /v1/meta` — Service metadata

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


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