# DIA Decentralized Price Oracle API
> Live decentralized price-oracle data from DIA, with no key. DIA aggregates trade data across many CEXes and DEXes into transparent on-chain price feeds. Get a symbol quotation (current price, yesterday's price, 24h change and volume); an asset quotation by blockchain and contract address — the same multi-chain oracle feed smart contracts consume; the catalogue of quoted assets with their chain, address and volume; and the list of supported symbols. Distinct from CEX tickers and CoinGecko-style aggregators: these are oracle reference prices across 949 symbols and 5,500+ assets.

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

## Pricing
- **Free** (Free) — 1,640 calls/Mo, 3 req/s
- **Basic** ($14/Mo) — 47,200 calls/Mo, 8 req/s
- **Pro** ($41/Mo) — 191,000 calls/Mo, 18 req/s
- **Business** ($85/Mo) — 792,000 calls/Mo, 46 req/s

## Endpoints

### Oracle

#### `GET /v1/asset` — Oracle quotation by blockchain + contract address

**Parameters:**
- `blockchain` (query, required, string) — Blockchain name Example: `Ethereum`
- `address` (query, required, string) — Contract address (native = 0x000…0) Example: `0x0000000000000000000000000000000000000000`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dia-api/v1/asset?blockchain=Ethereum&address=0x0000000000000000000000000000000000000000"
```

**Response:**
```json
{
    "data": {
        "name": "Ether",
        "time": "2026-06-15T11:13:59Z",
        "source": "diadata.org",
        "symbol": "ETH",
        "address": "0x0000000000000000000000000000000000000000",
        "price_usd": 1739.609303910375,
        "blockchain": "Ethereum",
        "change_24h_percent": 4.0578,
        "price_yesterday_usd": 1671.7725287549868,
        "volume_yesterday_usd": 2460795454.577498
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:41.753Z",
        "request_id": "55ed6a97-0e3d-4990-a6cb-f6ba107790eb"
    },
    "status": "ok",
    "message": "Asset quotation retrieved successfully",
    "success": true
}
```

#### `GET /v1/assets` — Catalogue of quoted assets

**Parameters:**
- `blockchain` (query, optional, string) — Filter by blockchain Example: `Ethereum`
- `limit` (query, optional, string) — Number of assets (1-500) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dia-api/v1/assets?blockchain=Ethereum&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "total": 3274,
        "assets": [
            {
                "name": "Ether",
                "symbol": "ETH",
                "address": "0x0000000000000000000000000000000000000000",
                "decimals": 18,
                "blockchain": "Ethereum",
                "volume_usd": 0
            },
            {
                "name": "USD Coin",
                "symbol": "USDC",
                "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
                "decimals": 6,
                "blockchain": "Ethereum",
                "volume_usd": 0
            },
            {
                "name": "Tether USD",
                "symbol": "USDT",
                "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
                "decimals": 6,
                "blockchain": "Ethereum",
                "volume_usd": 0
            },
            {
                "name": "Worldcoin",
                "symbol": "WLD",
                "address": "0x163f8C2467924be0ae7B5347228CABF260318753",
                "decimals": 18,
                "blockchain": "Ethereum",
                "volume_usd": 0
            },
            {
                "name": "Wrapped Ether",
                "symbol": "WETH",
                "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
                "decimals": 18,
                "blockchain": "Ethereum",
                "volume_usd": 0
            },
            {
               
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/quotation` — Oracle quotation by symbol

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

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

**Response:**
```json
{
    "data": {
        "name": "Bitcoin",
        "time": "2026-06-15T11:13:59Z",
        "source": "diadata.org",
        "symbol": "BTC",
        "address": "0x0000000000000000000000000000000000000000",
        "price_usd": 65941.04094560664,
        "blockchain": "Bitcoin",
        "change_24h_percent": 2.2462,
        "price_yesterday_usd": 64492.43785382183,
        "volume_yesterday_usd": 8204462601.628017
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:43.082Z",
        "request_id": "f53e4a49-06e0-4592-9820-c3ea8498f4c3"
    },
    "status": "ok",
    "message": "Quotation retrieved successfully",
    "success": true
}
```

#### `GET /v1/symbols` — All supported symbols

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

**Response:**
```json
{
    "data": {
        "count": 949,
        "symbols": [
            "BTC",
            "ETH",
            "USDC",
            "SOL",
            "USDT",
            "XRP",
            "WLD",
            "WETH",
            "ADA",
            "DOGE",
            "TAO",
            "cbBTC",
            "HYPE",
            "WBNB",
            "SUI",
            "NEAR",
            "BNB",
            "TON",
            "WBTC",
            "BTCB",
            "ZEC",
            "TRX",
            "XAUt",
            "USDe",
            "USDG",
            "AVAX",
            "EUR",
            "ENA",
            "USDS",
            "LTC",
            "XMR",
            "AAVE",
            "XLM",
            "PEPE",
            "ONDO",
            "ICP",
            "FDUSD",
            "UNI",
            "LINK",
            "POO",
            "VUE",
            "INJ",
            "VIRTUAL",
            "BCH",
            "GBP",
            "PYUSD",
            "CRV",
            "DOT",
            "crvUSD",
            "ASTEROID",
            "PAXG",
            "VVV",
            "FET",
            "FIL",
            "ARB",
            "BTC.b",
            "stETH",
            "STG",
            "ASTER",
            "TIA",
            "MNT",
            "STRK",
            "ATOM",
            "SHIB",
            "RNDR",
            "ZRO",
            "SEI",
            "USDtb",
            "Bonk",
            "ORDI",
            "SOXXon",
            "DAI",
            "ETHFI"
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Provider metadata & endpoint guide

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

**Response:**
```json
{
    "data": {
        "note": "DIA prices are transparent oracle reference prices aggregated across CEX/DEX trades; query by symbol or by blockchain + contract address (native = 0x000…0).",
        "source": "DIA public REST (api.diadata.org/v1), keyless",
        "examples": {
            "asset": "/v1/asset?blockchain=Ethereum&address=0x0000000000000000000000000000000000000000",
            "assets": "/v1/assets?blockchain=Ethereum&limit=50",
            "symbols": "/v1/symbols",
            "quotation": "/v1/quotation?symbol=BTC"
        },
        "provider": "DIA (Decentralised Information Asset)",
        "endpoints": {
            "/v1/asset": "oracle quotation by blockchain + contract address (blockchain, address)",
            "/v1/assets": "catalogue of quoted assets with chain, address & volume (filter blockchain, limit)",
            "/v1/symbols": "all supported symbols",
            "/v1/quotation": "oracle quotation by symbol: price, yesterday's price, 24h change & volume (symbol=BTC)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:43.544Z",
        "request_id": "c6c4afd3-7c41-4f81-b75e-d07cadf2e2a2"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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