# 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"
```

**Response:**
```json
{
    "data": {
        "ask": 193648.11,
        "bid": 186987.65,
        "coin": "btc",
        "fiat": "ILS",
        "last": 190292,
        "pair": "BTC/ILS",
        "venue": "Bit2C",
        "source": "Bit2C",
        "spread": 6660.46,
        "spread_pct": 3.4395,
        "average_24h": 189323.82795600043,
        "volume_24h_coin": 1.35502202
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:23.766Z",
        "request_id": "36a096da-a71a-4579-b6f2-e7d5f7051277"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

### 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"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "price": 193648.11,
                "amount": 0.23872756
            },
            {
                "price": 193650.02,
                "amount": 0.10092175
            },
            {
                "price": 193745.14,
                "amount": 0.93164101
            },
            {
                "price": 193792.09,
                "amount": 0.34364101
            },
            {
                "price": 193850.12,
                "amount": 0.23872756
            },
            {
                "price": 193851.07,
                "amount": 0.10092175
            },
            {
                "price": 194051.13,
                "amount": 0.92464101
            },
            {
                "price": 194244.56,
                "amount": 0.92964101
            },
            {
                "price": 194252.59,
                "amount": 0.34864101
            },
            {
                "price": 194446.2,
                "amount": 0.33764101
            },
            {
                "price": 196009.13,
                "amount": 0.02342
            },
            {
                "price": 209800,
                "amount": 1.46925433
            },
            {
                "price": 210000,
                "amount": 0.03333333
            },
            {
                "price": 210700,
                "amount": 0.12627666
            },
            {
                "price": 217000,
    
…(truncated, see openapi.json for full schema)
```

### 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"
```

**Response:**
```json
{
    "data": {
        "coin": "btc",
        "fiat": "ILS",
        "pair": "BTC/ILS",
        "count": 17,
        "venue": "Bit2C",
        "source": "Bit2C",
        "trades": [
            {
                "side": "sell",
                "time": "2026-06-11T18:03:41.000Z",
                "price": 195000,
                "trade_id": 2766525,
                "amount_coin": 0.00074285
            },
            {
                "side": "sell",
                "time": "2026-06-11T18:03:40.000Z",
                "price": 195000,
                "trade_id": 2766523,
                "amount_coin": 0.32008759
            },
            {
                "side": "buy",
                "time": "2026-06-11T17:30:12.000Z",
                "price": 192905.34,
                "trade_id": 2766511,
                "amount_coin": 0.005183889673556989
            },
            {
                "side": "sell",
                "time": "2026-06-11T15:01:37.000Z",
                "price": 190292,
                "trade_id": 2766484,
                "amount_coin": 0.0239
            },
            {
                "side": "buy",
                "time": "2026-06-11T14:11:23.000Z",
                "price": 190292.01,
                "trade_id": 2766476,
                "amount_coin": 0.12612195330744574
            },
            {
                "side": "sell",
                "time": "2026-06-11T14:10:25.000Z",
                "price": 190991,
                "trade_id": 2766472,
     
…(truncated, see openapi.json for full schema)
```

### 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"
```

**Response:**
```json
{
    "data": {
        "fiat": "ILS",
        "count": 6,
        "venue": "Bit2C",
        "source": "Bit2C",
        "markets": [
            {
                "coin": "btc",
                "fiat": "ILS",
                "last": 190292,
                "pair": "BTC/ILS",
                "average_24h": 189323.82795600043,
                "volume_24h_coin": 1.35502202
            },
            {
                "coin": "eth",
                "fiat": "ILS",
                "last": 4930,
                "pair": "ETH/ILS",
                "average_24h": 4972.717703427267,
                "volume_24h_coin": 12.91177427
            },
            {
                "coin": "ltc",
                "fiat": "ILS",
                "last": 132.68,
                "pair": "LTC/ILS",
                "average_24h": 129.60819646796358,
                "volume_24h_coin": 229.75227502
            },
            {
                "coin": "bch",
                "fiat": "ILS",
                "last": 849.98246223,
                "pair": "BCH/ILS",
                "average_24h": 850.0120959696266,
                "volume_24h_coin": 0
            },
            {
                "coin": "grin",
                "fiat": "ILS",
                "last": 1.13,
                "pair": "GRIN/ILS",
                "average_24h": 1.1275911709564588,
                "volume_24h_coin": 0
            },
            {
                "coin": "usdc",
                "fiat": "ILS",
                "last": 3,
 
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "All pairs settle in the Israeli new shekel (ILS/NIS). coin is one of btc, eth, ltc, bch, grin, usdc.",
        "source": "Bit2C public API (bit2c.co.il/Exchanges, live)",
        "service": "bit2c-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/ticker": "Pair market summary (coin=btc).",
            "GET /v1/trades": "Most recent executed trades (coin=btc, limit=20).",
            "GET /v1/markets": "Every shekel pair with last price and 24h volume.",
            "GET /v1/orderbook": "Live limit-order book with depth and spread (coin=btc, limit=20)."
        },
        "description": "Live order-book exchange data from Bit2C, the veteran Israeli crypto exchange, over its public API. The regional venue view for the Israeli new shekel (ILS / NIS) order books — Israeli on-exchange price discovery. ticker = a pair's market summary (last, live best bid/ask, spread, 24h volume, 24h average); orderbook = the live limit-order book (top bids/asks, cumulative depth, spread); trades = the most recent executed trades; markets = every shekel pair the venue trades. Live, no key, nothing stored. Distinct from the global-aggregate and the other regional-exchange APIs.",
        "btc_ils_last": 190292,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:24.632Z",
        "request_id": "3da0f559-20d0-4dec-b0e2-8df8d69ad8e3"
    },
    "status": "ok",
    "message": "Meta",
…(truncated, see openapi.json for full schema)
```


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