> For the complete documentation index, see [llms.txt](https://docs.bbx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bbx.com/ja/bbx-dex-gong-kai-api/coingecko-lian-xie/zhu-wen-ban.md).

# 注文板

指定された対象の現在の注文板の深さを返します **BBX DEX** 暗号資産の永久先物市場。

レスポンスには個別の `買い注文` と `売り注文` 配列が含まれます。各価格レベルは次のように表されます: `[価格, 数量]` のペアで、両方の値は文字列として返されます。

***

### エンドポイント

```http
GET /fapi/market/v1/public/coingecko/orderbook
```

### 完全なURL

```
https://dex.bbx.com/fapi/market/v1/public/coingecko/orderbook
```

***

### 認証

認証は不要です。

このエンドポイントは公開アクセス可能であり、以下は不要です:

* APIキー
* リクエスト署名
* ログイン認証情報
* 認証トークン
* カスタムリクエストヘッダー

***

### クエリパラメータ

| パラメータ       | 型   |  必須 | 説明                                    |
| ----------- | --- | --: | ------------------------------------- |
| `ticker_id` | 文字列 |  はい | 契約識別子 `BASE-TARGET` 形式、例えば `BTC-USDT` |
| `depth`     | 整数  | いいえ | 買い側と売り側を合わせた、要求された注文板レベルの総数           |

***

### ペア命名規則

その `ticker_id` 次の形式を使用する必要があります:

```
BASE-TARGET
```

例:

```
BTC-USDT
ETH-USDT
SOL-USDT
```

***

### 深さのルール

その `depth` パラメータは、注文板の両側を合わせた要求レベル数の合計を表します。

例:

|  要求深さ | 最大買いレベル数 | 最大売りレベル数 |
| ----: | -------: | -------: |
| `100` |       50 |       50 |
| `200` |      100 |      100 |

depth が奇数の場合、要求された深さは両側に分割され、必要に応じて切り上げられます。

If `depth` が省略されるか、 `0`、エンドポイントは利用可能な最大深さを返します。各側の上限は500レベルです。

以上の値は `1000` 利用可能な最大深さの要求として扱われます。

負の `depth` 値は `invalid_depth` エラーを返します。

***

### リクエスト例

```bash
curl -s \\
  'https://dex.bbx.com/fapi/market/v1/public/coingecko/orderbook?ticker_id=BTC-USDT&depth=200'
```

***

### レスポンス例

```json
{
  "ticker_id": "BTC-USDT",
  "timestamp": 1721548812345,
  "bids": [
    ["67249.8", "0.512"],
    ["67249.5", "1.203"]
  ],
  "asks": [
    ["67251.2", "0.877"],
    ["67251.9", "2.014"]
  ]
}
```

> 上記の値は例示です。実際のレスポンスには現在のBBX市場データが含まれます。

***

### レスポンス項目

| 項目          | 型   | 要件 | 説明                                 |
| ----------- | --- | -- | ---------------------------------- |
| `ticker_id` | 文字列 | 必須 | 契約識別子 `BASE-TARGET` format         |
| `timestamp` | 整数  | 推奨 | 注文板の更新時刻をミリ秒単位のUnixタイムスタンプで表したもの   |
| `買い注文`      | 配列  | 必須 | 買いレベルを次の形式で表したもの: `[価格, 数量]` 文字列ペア |
| `売り注文`      | 配列  | 必須 | 売りレベルを次の形式で表したもの: `[価格, 数量]` 文字列ペア |

***

### 注文の並び順

買いレベルは高い価格から低い価格へ並べ替えられます。

売りレベルは低い価格から高い価格へ並べ替えられます。

各価格レベルは次のように表されます:

```json
["価格", "数量"]
```

例:

```json
["67249.8", "0.512"]
```

この例では:

* `67249.8` が価格です
* `0.512` がその価格レベルで利用可能な数量です

***

### タイムスタンプの単位

その `timestamp` フィールドはミリ秒単位のUnixタイムスタンプとして返されます。

例:

```
1721548812345
```

***

### 空の注文板

注文板データが一時的に利用できない場合、まだ深さキャッシュが構築されていない新規上場契約を含め、エンドポイントはHTTP `200` 空の `買い注文` と `売り注文` 配列を返します。

例:

```json
{
  "ticker_id": "BTC-USDT",
  "timestamp": 1721548812345,
  "bids": [],
  "asks": []
}
```

この条件では、エンドポイントは空のレスポンス本文を返しません。

***

### 不正なリクエスト

不明、無効、または未対応の契約識別子は次を返します: `invalid_symbol` エラーを返します。

負の `depth` 値は `invalid_depth` エラーを返します。

次を参照してください: **エラー処理** 該当するエラーレスポンス形式についてのセクション。