# Aster Perpetual Futures DEX API
> Live market data for Aster (asterdex), the perpetual-futures DEX, with no key. List every perpetual symbol with contract specs; pull a 24h ticker (last/high/low/open price, percentage change, volume) for one symbol or all 480+ markets; get the funding feed with mark price, index price and the latest funding rate; read the live order book; stream recent public trades; and fetch OHLC candlesticks across multiple intervals. Symbols are Binance-style tickers (BTCUSDT, ETHUSDT) — ideal for derivatives dashboards, funding-rate 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/aster-api/..."
```

## Pricing
- **Free** (Free) — 2,050 calls/Mo, 4 req/s
- **Basic** ($19/Mo) — 58,500 calls/Mo, 10 req/s
- **Pro** ($52/Mo) — 232,000 calls/Mo, 24 req/s
- **Business** ($114/Mo) — 930,000 calls/Mo, 58 req/s

## Endpoints

### Markets

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

**Parameters:**
- `symbol` (query, required, string) — Aster symbol Example: `ETHUSDT`
- `limit` (query, optional, string) — Levels: 5,10,20,50,100,500,1000 Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aster-api/v1/depth?symbol=ETHUSDT&limit=20"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "size": 10.323,
                "price": 1740.68
            },
            {
                "size": 49.512,
                "price": 1740.7
            },
            {
                "size": 128.672,
                "price": 1740.71
            },
            {
                "size": 148.014,
                "price": 1740.72
            },
            {
                "size": 21.254,
                "price": 1740.76
            },
            {
                "size": 53.842,
                "price": 1740.79
            },
            {
                "size": 128.672,
                "price": 1740.81
            },
            {
                "size": 14.36,
                "price": 1740.87
            },
            {
                "size": 51.881,
                "price": 1740.89
            },
            {
                "size": 137.895,
                "price": 1740.9
            },
            {
                "size": 44.034,
                "price": 1740.97
            },
            {
                "size": 137.915,
                "price": 1740.98
            },
            {
                "size": 140.948,
                "price": 1741.04
            },
            {
                "size": 58.536,
                "price": 1741.11
            },
            {
                "size": 152.895,
                "price": 1741.12
            },
            {
                "size": 71.07,
       
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/funding` — Mark/index price and latest funding rate

**Parameters:**
- `symbol` (query, optional, string) — Aster symbol Example: `BTCUSDT`

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

**Response:**
```json
{
    "data": {
        "symbol": "BTCUSDT",
        "mark_price": 65935.2,
        "index_price": 65972.03217391,
        "interest_rate": 0.0001,
        "last_funding_rate": -2.174e-5,
        "next_funding_time": 1781539200000,
        "estimated_settle_price": 65805.93467271
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:51.401Z",
        "request_id": "c3eaa6dd-6414-40fc-b177-33d45b168a12"
    },
    "status": "ok",
    "message": "Funding retrieved successfully",
    "success": true
}
```

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

**Parameters:**
- `symbol` (query, required, string) — Aster symbol Example: `BTCUSDT`
- `interval` (query, optional, string) — Candle interval (1m,5m,15m,1h,4h,1d,…) Example: `1h`
- `limit` (query, optional, string) — Candles (1-500) Example: `100`

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

**Response:**
```json
{
    "data": {
        "count": 100,
        "klines": [
            {
                "low": 62689.2,
                "high": 63018.6,
                "open": 62689.3,
                "close": 62926.1,
                "trades": 4129,
                "volume": 543.891,
                "open_time": 1781164800000,
                "close_time": 1781168399999,
                "quote_volume": 34207206.5732
            },
            {
                "low": 62760,
                "high": 62968.8,
                "open": 62926.2,
                "close": 62898.4,
                "trades": 3887,
                "volume": 298.451,
                "open_time": 1781168400000,
                "close_time": 1781171999999,
                "quote_volume": 18761565.2189
            },
            {
                "low": 62774,
                "high": 63199.9,
                "open": 62901.3,
                "close": 63129,
                "trades": 4432,
                "volume": 478.295,
                "open_time": 1781172000000,
                "close_time": 1781175599999,
                "quote_volume": 30126390.4624
            },
            {
                "low": 63027.7,
                "high": 63237.5,
                "open": 63122.5,
                "close": 63080.1,
                "trades": 4514,
                "volume": 533.831,
                "open_time": 1781175600000,
                "close_time": 1781179199999,
                "quote_volume": 33705431.1252
           
…(truncated, see openapi.json for full schema)
```

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

**Parameters:**
- `base` (query, optional, string) — Filter by base asset Example: `BTC`

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

**Response:**
```json
{
    "data": {
        "count": 3,
        "venue": "aster",
        "markets": [
            {
                "status": "TRADING",
                "symbol": "BTCUSDT",
                "base_asset": "BTC",
                "quote_asset": "USDT",
                "price_precision": 1,
                "quantity_precision": 3
            },
            {
                "status": "TRADING",
                "symbol": "BTCUSD1",
                "base_asset": "BTC",
                "quote_asset": "USD1",
                "price_precision": 2,
                "quantity_precision": 3
            },
            {
                "status": "TRADING",
                "symbol": "BTCU",
                "base_asset": "BTC",
                "quote_asset": "U",
                "price_precision": 2,
                "quantity_precision": 3
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:51.822Z",
        "request_id": "c78c6999-6793-48d6-a44d-1762ec088385"
    },
    "status": "ok",
    "message": "Markets retrieved successfully",
    "success": true
}
```

#### `GET /v1/ticker` — 24h ticker for a symbol or all markets

**Parameters:**
- `symbol` (query, optional, string) — Aster symbol Example: `BTCUSDT`

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

**Response:**
```json
{
    "data": {
        "low": 63653.2,
        "high": 65978,
        "last": 65935.2,
        "open": 64537.5,
        "symbol": "BTCUSDT",
        "trades": 91383,
        "volume": 12460.827,
        "price_change": 1397.7,
        "quote_volume": 811545758.88,
        "weighted_avg": 65127.8,
        "price_change_pct": 2.166
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:52.158Z",
        "request_id": "bb52d116-9f12-412e-8ae1-3fb150cc3fd4"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

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

**Parameters:**
- `symbol` (query, required, string) — Aster symbol Example: `BTCUSDT`
- `limit` (query, optional, string) — Number of trades (1-100) Example: `25`

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

**Response:**
```json
{
    "data": {
        "count": 25,
        "symbol": "BTCUSDT",
        "trades": [
            {
                "id": 138304137,
                "size": 0.514,
                "time": 1781522135975,
                "price": 65905.2,
                "quote_qty": 33875.2,
                "buyer_maker": true
            },
            {
                "id": 138304138,
                "size": 0.001,
                "time": 1781522136700,
                "price": 65905.3,
                "quote_qty": 65.9,
                "buyer_maker": false
            },
            {
                "id": 138304139,
                "size": 0.006,
                "time": 1781522136700,
                "price": 65905.3,
                "quote_qty": 395.4,
                "buyer_maker": false
            },
            {
                "id": 138304140,
                "size": 0.669,
                "time": 1781522137610,
                "price": 65915.1,
                "quote_qty": 44097.1,
                "buyer_maker": false
            },
            {
                "id": 138304141,
                "size": 0.001,
                "time": 1781522137900,
                "price": 65915.2,
                "quote_qty": 65.9,
                "buyer_maker": false
            },
            {
                "id": 138304142,
                "size": 0.003,
                "time": 1781522137900,
                "price": 65915.2,
                "quote_qty": 197.7,
                "buyer_maker": 
…(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/aster-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "venue": "Aster",
        "source": "Aster public futures REST (fapi.asterdex.com/fapi/v1), keyless",
        "examples": {
            "depth": "/v1/depth?symbol=ETHUSDT&limit=20",
            "klines": "/v1/klines?symbol=BTCUSDT&interval=1h&limit=100",
            "ticker": "/v1/ticker?symbol=BTCUSDT",
            "trades": "/v1/trades?symbol=BTCUSDT&limit=10",
            "funding": "/v1/funding?symbol=BTCUSDT",
            "markets": "/v1/markets?base=BTC"
        },
        "endpoints": {
            "/v1/depth": "live order book (symbol, limit in 5/10/20/50/100/500/1000)",
            "/v1/klines": "OHLC candlesticks (symbol, interval, limit)",
            "/v1/ticker": "24h ticker for a symbol or all (symbol optional)",
            "/v1/trades": "recent public trades (symbol, limit)",
            "/v1/funding": "mark/index price and latest funding rate for a symbol or all (symbol optional)",
            "/v1/markets": "list every perpetual symbol with specs (filter base=BTC)"
        },
        "intervals": [
            "1m",
            "3m",
            "5m",
            "15m",
            "30m",
            "1h",
            "2h",
            "4h",
            "6h",
            "8h",
            "12h",
            "1d",
            "3d",
            "1w",
            "1M"
        ],
        "instrument": "perpetual futures",
        "cache_ttl_ms": 5000,
        "depth_limits": [
            5,
            10,
            20,
            50,
…(truncated, see openapi.json for full schema)
```


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