# Bit2C Israel Exchange API
> Live order-book exchange data from Bit2C, the veteran Israeli crypto exchange, over its public API — no key, nothing stored. This is the regional venue view for the Israeli new shekel (ILS / NIS) order books: Israeli on-exchange price discovery, distinct from the global-aggregate and the other regional-exchange APIs in the catalogue. The ticker endpoint returns a pair market summary — last traded price, the live best bid and offer, the implied spread, the 24h volume and the 24h average price. The orderbook endpoint returns the live limit-order book — top bids and asks with cumulative depth and the bid/ask spread — so you can read on-venue liquidity. The trades endpoint returns the most recent executed trades with price, amount, side and time. The markets endpoint lists every shekel pair the venue trades. Coins traded include BTC, ETH, LTC, BCH, GRIN and USDC, all quoted in Israeli new shekel, updated live.

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

## Pricing
- **Free** (Free) — 14,500 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 215,000 calls/Mo, 10 req/s
- **Pro** ($24/Mo) — 830,000 calls/Mo, 28 req/s
- **Scale** ($53/Mo) — 3,150,000 calls/Mo, 60 req/s

## Endpoints

### Ticker

#### `GET /v1/ticker` — Pair market summary

**Parameters:**
- `coin` (query, required, string) — Coin: btc, eth, ltc, bch, grin, usdc Example: `btc`

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

### Orderbook

#### `GET /v1/orderbook` — Live limit-order book with depth

**Parameters:**
- `coin` (query, required, string) — Coin Example: `btc`
- `limit` (query, optional, string) — Levels per side (default 20, max 100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bit2c-api/v1/orderbook?coin=btc&limit=20"
```

### Trades

#### `GET /v1/trades` — Most recent executed trades

**Parameters:**
- `coin` (query, required, string) — Coin Example: `btc`
- `limit` (query, optional, string) — Trades (default 20, max 50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bit2c-api/v1/trades?coin=btc&limit=20"
```

### Markets

#### `GET /v1/markets` — Every shekel pair with last price and volume

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

### Meta

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

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


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