# Injective API
> Live on-chain exchange data from the Injective network (INJ), a layer-1 blockchain with a fully on-chain central-limit order book for spot and derivative trading: the on-chain spot markets with ticker, status, fees and tokens; the perpetual and futures markets with their live mark price, oracle, margin ratios and fees; a spot market's live on-chain order book (best bid/ask, mid, spread and depth, decoded to human prices); and single-market details.

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

## Pricing
- **Free** (Free) — 11,000 calls/Mo, 3 req/s
- **Basic** ($9/Mo) — 145,000 calls/Mo, 8 req/s
- **Pro** ($27/Mo) — 910,000 calls/Mo, 15 req/s
- **Scale** ($63/Mo) — 4,900,000 calls/Mo, 30 req/s

## Endpoints

### Markets

#### `GET /v1/derivative-markets` — Perpetual and futures markets with live mark price

**Parameters:**
- `limit` (query, optional, string) — Max markets (1-300) Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/injective-api/v1/derivative-markets?limit=100"
```

**Response:**
```json
{
    "data": {
        "type": "derivative",
        "count": 100,
        "total": 161,
        "source": "Injective",
        "markets": [
            {
                "status": null,
                "ticker": "1INCH/USDC PERP",
                "market_id": "0x97e9255c2ed063e9c3e07ecef08783f8a7ada3c4ece72cf7fb14e5d18affb444",
                "mid_price": null,
                "mark_price": 0.07084516,
                "oracle_type": "Pyth",
                "quote_denom": "erc20:0xa00C59fF5a080D2b954d0c75e46E22a0c371235a",
                "best_buy_price": null,
                "maker_fee_rate": 0.0001,
                "taker_fee_rate": 0.0001,
                "best_sell_price": null,
                "initial_margin_ratio": 18.1818,
                "hourly_funding_rate_cap": null,
                "maintenance_margin_ratio": 10
            },
            {
                "status": null,
                "ticker": "A/USDC PERP",
                "market_id": "0xbbeeab469a0dd70c6ba3df283f084726a9b9896bdbdffce1432e82f881d756a7",
                "mid_price": null,
                "mark_price": 0.06456559,
                "oracle_type": "Pyth",
                "quote_denom": "erc20:0xa00C59fF5a080D2b954d0c75e46E22a0c371235a",
                "best_buy_price": null,
                "maker_fee_rate": 0.0001,
                "taker_fee_rate": 0.0001,
                "best_sell_price": null,
                "initial_margin_ratio": 18.1818,
                "hourly_funding_rate_cap": nu
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/market` — A single market details, spot or derivative

**Parameters:**
- `market_id` (query, required, string) — Market id (0x + 64 hex) Example: `0xa508cb32923323679f29a032c70342c147c17d0145625922b0ef22e955c844c0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/injective-api/v1/market?market_id=0xa508cb32923323679f29a032c70342c147c17d0145625922b0ef22e955c844c0"
```

**Response:**
```json
{
    "data": {
        "type": "spot",
        "source": "Injective",
        "status": null,
        "ticker": "INJ/USDT",
        "market_id": "0xa508cb32923323679f29a032c70342c147c17d0145625922b0ef22e955c844c0",
        "base_denom": "inj",
        "quote_denom": "peggy0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "base_decimals": 18,
        "maker_fee_rate": 0,
        "quote_decimals": 6,
        "taker_fee_rate": 0.05,
        "min_price_tick_size": "0.000000000000001000"
    },
    "meta": {
        "timestamp": "2026-06-10T14:01:31.749Z",
        "request_id": "db132afd-01c4-480d-80b8-31c9c15fc235"
    },
    "status": "ok",
    "message": "Market retrieved successfully",
    "success": true
}
```

#### `GET /v1/spot-markets` — Injective on-chain spot markets

**Parameters:**
- `limit` (query, optional, string) — Max markets (1-300) Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/injective-api/v1/spot-markets?limit=100"
```

**Response:**
```json
{
    "data": {
        "type": "spot",
        "count": 100,
        "total": 141,
        "source": "Injective",
        "markets": [
            {
                "status": null,
                "ticker": "AAVE/USDT",
                "market_id": "0x01edfab47f124748dc89998eb33144af734484ba07099014594321729a0ca16b",
                "base_denom": "peggy0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9",
                "quote_denom": "peggy0xdAC17F958D2ee523a2206206994597C13D831ec7",
                "base_decimals": 18,
                "maker_fee_rate": -0.005,
                "quote_decimals": 6,
                "taker_fee_rate": 0.2,
                "min_price_tick_size": "0.000000000000001000"
            },
            {
                "status": null,
                "ticker": "AGENT/INJ",
                "market_id": "0x8130d65840e1f5d8350c9311beed80ab669c15695c300157df701ab1c4df27e2",
                "base_denom": "factory/inj16dd5xzszud3u5wqphr3tq8eaz00gjdn3d4mvj8/agent",
                "quote_denom": "inj",
                "base_decimals": 6,
                "maker_fee_rate": -0.005,
                "quote_decimals": 18,
                "taker_fee_rate": 0.05,
                "min_price_tick_size": "10000.000000000000000000"
            },
            {
                "status": null,
                "ticker": "AGENT/USDT",
                "market_id": "0x9f040f69b9c3c09f6245b5927813d627806fefe924775d49b2390df4899ba206",
                "base_denom": "factory/inj16dd5xzsz
…(truncated, see openapi.json for full schema)
```

### Orderbook

#### `GET /v1/orderbook` — A spot market live on-chain order book

**Parameters:**
- `market_id` (query, required, string) — Spot market id (0x + 64 hex) Example: `0xa508cb32923323679f29a032c70342c147c17d0145625922b0ef22e955c844c0`
- `depth` (query, optional, string) — Levels per side (1-50) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/injective-api/v1/orderbook?market_id=0xa508cb32923323679f29a032c70342c147c17d0145625922b0ef22e955c844c0&depth=10"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "price": 5.266,
                "quantity": 771.54
            },
            {
                "price": 5.275,
                "quantity": 1427.891
            },
            {
                "price": 5.279,
                "quantity": 857.878
            },
            {
                "price": 5.317,
                "quantity": 1282.11
            },
            {
                "price": 5.319,
                "quantity": 1209.346
            },
            {
                "price": 5.321,
                "quantity": 1316.644
            },
            {
                "price": 5.328,
                "quantity": 64.071
            },
            {
                "price": 5.331,
                "quantity": 3835.027
            },
            {
                "price": 5.335,
                "quantity": 3.73
            },
            {
                "price": 5.342,
                "quantity": 16.813
            }
        ],
        "bids": [
            {
                "price": 5.254,
                "quantity": 1282.842
            },
            {
                "price": 5.24,
                "quantity": 1425.856
            },
            {
                "price": 5.236,
                "quantity": 858.042
            },
            {
                "price": 5.225,
                "quantity": 3714.094
            },
            {
                "price": 5.222,
                "quantity": 65.743
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata and endpoint catalog

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

**Response:**
```json
{
    "data": {
        "source": "Injective Cosmos REST API (sentry.lcd.injective.network, live)",
        "service": "injective-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/market": "A single market's details, spot or derivative (market_id).",
            "GET /v1/orderbook": "A spot market's live on-chain order book (market_id, depth).",
            "GET /v1/spot-markets": "Injective on-chain spot markets (limit).",
            "GET /v1/derivative-markets": "Perpetual and futures markets with live mark price (limit)."
        },
        "description": "Live on-chain exchange data from the Injective network (INJ), a layer-1 blockchain with a fully on-chain central-limit order book for spot and derivative trading, via a public Injective REST node. The spot-markets endpoint lists Injective's on-chain spot markets; the derivative-markets endpoint lists perpetual and futures markets with their live mark price, oracle, margin ratios and fees; the orderbook endpoint returns a spot market's live on-chain order book (best bid/ask, mid, spread and depth, decoded to human prices); the market endpoint returns a single market's details. Live, no key, nothing stored. Distinct from centralised exchange tickers and from the Cosmos, Celestia and other on-chain balance APIs — this is Injective's own on-chain exchange order book and derivative markets.",
        "upstream_status": "ok",
        "spot_market_count": 141
    },
    "meta": {
…(truncated, see openapi.json for full schema)
```


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