# Hibachi Perpetuals DEX API
> Live market data for Hibachi, the perpetuals DEX, with no key. List every perpetual contract; pull a per-symbol price snapshot with bid/ask, mark price, spot price and the estimated funding rate; get 24h high/low/volume stats; read the live order book; stream recent public trades; and fetch OHLC candlesticks across multiple intervals. Symbols are accepted as a coin ticker (BTC) or the full contract symbol (BTC/USDT-P) and resolved automatically — ideal for derivatives dashboards, funding monitors and charting.

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

## Pricing
- **Free** (Free) — 1,640 calls/Mo, 3 req/s
- **Basic** ($14/Mo) — 46,800 calls/Mo, 8 req/s
- **Pro** ($40/Mo) — 187,000 calls/Mo, 19 req/s
- **Business** ($86/Mo) — 772,000 calls/Mo, 47 req/s

## Endpoints

### Markets

#### `GET /v1/klines` — OHLC candlesticks for a symbol

**Parameters:**
- `symbol` (query, required, string) — Coin ticker or contract symbol Example: `BTC`
- `interval` (query, optional, string) — Candle interval (1m,5m,15m,30m,1h,4h,1d,1w) Example: `1h`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hibachi-api/v1/klines?symbol=BTC&interval=1h"
```

**Response:**
```json
{
    "data": {
        "count": 1000,
        "klines": [
            {
                "low": 79883.5,
                "high": 80138.8,
                "open": 80036.8,
                "close": 79925.8,
                "timestamp": 1777924800,
                "volume_notional": 296804.439457
            },
            {
                "low": 79925.8,
                "high": 80362.7,
                "open": 79925.8,
                "close": 80244.7,
                "timestamp": 1777928400,
                "volume_notional": 360036.209576
            },
            {
                "low": 80040,
                "high": 80381.7,
                "open": 80244.7,
                "close": 80062.5,
                "timestamp": 1777932000,
                "volume_notional": 363534.554736
            },
            {
                "low": 79747.2,
                "high": 80062.5,
                "open": 80062.5,
                "close": 79844.3,
                "timestamp": 1777935600,
                "volume_notional": 315883.960746
            },
            {
                "low": 79799.5,
                "high": 80159.1,
                "open": 79844.3,
                "close": 80159.1,
                "timestamp": 1777939200,
                "volume_notional": 300332.076692
            },
            {
                "low": 80067.3,
                "high": 80366,
                "open": 80159.1,
                "close": 80334.1,
                "timestamp": 1777942800,
   
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/markets` — List every perpetual contract with specs

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

**Response:**
```json
{
    "data": {
        "count": 11,
        "venue": "hibachi",
        "markets": [
            {
                "status": "LIVE",
                "symbol": "ETH/USDT-P",
                "tick_size": 0.01,
                "settlement": "USDT",
                "underlying": "ETH",
                "max_leverage": null,
                "min_order_size": 1.0e-9
            },
            {
                "status": "LIVE",
                "symbol": "BTC/USDT-P",
                "tick_size": 0.1,
                "settlement": "USDT",
                "underlying": "BTC",
                "max_leverage": null,
                "min_order_size": 1.0e-10
            },
            {
                "status": "LIVE",
                "symbol": "SOL/USDT-P",
                "tick_size": 0.001,
                "settlement": "USDT",
                "underlying": "SOL",
                "max_leverage": null,
                "min_order_size": 1.0e-8
            },
            {
                "status": "LIVE",
                "symbol": "SUI/USDT-P",
                "tick_size": 1.0e-5,
                "settlement": "USDT",
                "underlying": "SUI",
                "max_leverage": null,
                "min_order_size": 1.0e-6
            },
            {
                "status": "LIVE",
                "symbol": "XRP/USDT-P",
                "tick_size": 1.0e-5,
                "settlement": "USDT",
                "underlying": "XRP",
                "max_leverage": null,
     
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/orderbook` — Live order book for a symbol

**Parameters:**
- `symbol` (query, required, string) — Coin ticker or contract symbol Example: `BTC`
- `depth` (query, optional, string) — Levels (1-100) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hibachi-api/v1/orderbook?symbol=BTC&depth=10"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "size": 0.1014217906,
                "price": 65960.8
            },
            {
                "size": 0.0002974803,
                "price": 65961
            },
            {
                "size": 0.1516092463,
                "price": 65961.5
            },
            {
                "size": 0.0454866468,
                "price": 65961.7
            },
            {
                "size": 0.4610410621,
                "price": 65962.7
            },
            {
                "size": 0.049,
                "price": 65963.1
            },
            {
                "size": 0.0005502112,
                "price": 65963.4
            },
            {
                "size": 0.0231090748,
                "price": 65963.6
            },
            {
                "size": 0.9500632632,
                "price": 65963.7
            },
            {
                "size": 0.0758101627,
                "price": 65963.8
            }
        ],
        "bids": [
            {
                "size": 0.0007108953,
                "price": 65960.6
            },
            {
                "size": 2.3146943955,
                "price": 65955.1
            },
            {
                "size": 0.1516138431,
                "price": 65951.7
            },
            {
                "size": 0.0454866468,
                "price": 65948.5
            },
            {
                "size": 0.0227430
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/prices` — Price snapshot: bid/ask, mark, spot, funding

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

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

**Response:**
```json
{
    "data": {
        "ask": 65960.8,
        "bid": 65960.6,
        "symbol": "BTC/USDT-P",
        "mark_price": 65951.7,
        "spot_price": 65950.3025,
        "estimated_funding_rate": 1.5e-5,
        "next_funding_timestamp": 1781524800
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:54.260Z",
        "request_id": "13a7c18a-1d63-45b8-bcd3-75c4b0314423"
    },
    "status": "ok",
    "message": "Prices retrieved successfully",
    "success": true
}
```

#### `GET /v1/stats` — 24h high, low and volume

**Parameters:**
- `symbol` (query, required, string) — Coin ticker or contract symbol Example: `ETH`

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

**Response:**
```json
{
    "data": {
        "symbol": "ETH/USDT-P",
        "low_24h": 1654.99,
        "high_24h": 1747.57,
        "volume_24h": 1180084.800469
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:54.609Z",
        "request_id": "2a4f034d-23f8-4d03-b3f8-f37b681ea5ab"
    },
    "status": "ok",
    "message": "Stats retrieved successfully",
    "success": true
}
```

#### `GET /v1/trades` — Recent public trades for a symbol

**Parameters:**
- `symbol` (query, required, string) — Coin ticker or contract symbol Example: `BTC`
- `limit` (query, optional, string) — Number of trades (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hibachi-api/v1/trades?symbol=BTC&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "symbol": "BTC/USDT-P",
        "trades": [
            {
                "side": "Sell",
                "size": 0.0001686253,
                "price": 65956.5,
                "timestamp": 1781522154
            },
            {
                "side": "Buy",
                "size": 0.0016050993,
                "price": 65951.7,
                "timestamp": 1781522138
            },
            {
                "side": "Buy",
                "size": 0.0007583025,
                "price": 65949.9,
                "timestamp": 1781522138
            },
            {
                "side": "Buy",
                "size": 0.0002700739,
                "price": 65951.4,
                "timestamp": 1781522138
            },
            {
                "side": "Buy",
                "size": 0.0001805964,
                "price": 65947.7,
                "timestamp": 1781522138
            },
            {
                "side": "Buy",
                "size": 0.001184788,
                "price": 65947.8,
                "timestamp": 1781522138
            },
            {
                "side": "Buy",
                "size": 0.0002300369,
                "price": 65947.6,
                "timestamp": 1781522138
            },
            {
                "side": "Buy",
                "size": 0.000799,
                "price": 65935.3,
                "timestamp": 1781522128
            },
            {
                "side": "
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "venue": "Hibachi",
        "source": "Hibachi public data REST (data-api.hibachi.xyz), keyless",
        "examples": {
            "stats": "/v1/stats?symbol=ETH",
            "klines": "/v1/klines?symbol=BTC&interval=1h",
            "prices": "/v1/prices?symbol=BTC",
            "trades": "/v1/trades?symbol=BTC&limit=10",
            "markets": "/v1/markets",
            "orderbook": "/v1/orderbook?symbol=BTC&depth=10"
        },
        "endpoints": {
            "/v1/stats": "24h high, low and volume (symbol=BTC)",
            "/v1/klines": "OHLC candlesticks (symbol, interval)",
            "/v1/prices": "bid/ask, mark price, spot price and estimated funding rate (symbol=BTC)",
            "/v1/trades": "recent public trades (symbol, limit)",
            "/v1/markets": "list every perpetual contract with specs",
            "/v1/orderbook": "live order book (symbol, depth)"
        },
        "intervals": [
            "1m",
            "5m",
            "15m",
            "30m",
            "1h",
            "4h",
            "1d",
            "1w"
        ],
        "instrument": "perpetual futures",
        "cache_ttl_ms": 5000
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:55.013Z",
        "request_id": "3ecee367-00f0-426d-bebf-9f1dc3f9f5a5"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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