> 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/ko/bbx-dex-api/coingecko/order-book.md).

# 오더북

지정된 항목의 현재 오더북 깊이를 반환합니다 **BBX DEX** 암호화폐 무기한 선물 시장.

응답에는 별도의 `매수호가` 및 `매도호가` 배열이 포함됩니다. 각 가격 레벨은 다음과 같이 표현됩니다. `[price, quantity]` 쌍이며, 두 값 모두 문자열로 반환됩니다.

***

### 엔드포인트

```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` 생략되었거나 `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` 형식                          |
| `timestamp` | 정수  | 권장    | 오더북 업데이트 시간은 밀리초 단위의 Unix 타임스탬프로 표시됩니다               |
| `매수호가`      | 배열  | 필수    | 다음과 같은 문자열 쌍으로 표시된 매수호가 레벨 `[price, quantity]` 문자열 쌍 |
| `매도호가`      | 배열  | 필수    | 다음과 같은 문자열 쌍으로 표시된 매도호가 레벨 `[price, quantity]` 문자열 쌍 |

***

### 주문 정렬

매수호가 레벨은 가장 높은 가격에서 가장 낮은 가격 순으로 정렬됩니다.

매도호가 레벨은 가장 낮은 가격에서 가장 높은 가격 순으로 정렬됩니다.

각 가격 레벨은 다음과 같이 표시됩니다:

```json
["price", "quantity"]
```

예를 들면:

```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` 오류를 반환합니다.

다음을 참조하세요: **오류 처리** 섹션에서 적용 가능한 오류 응답 형식을 확인하세요.