> 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/contracts-and-contract-specifications.md).

# 계약 및 계약 사양

지원되는 활성 암호화폐 무기한 선물 시장을 반환합니다 **BBX DEX** CoinGecko 파생상품 거래소 통합용입니다.

이 엔드포인트는 CoinGecko의 **계약** 및 **계약 사양** 요구 사항을 하나의 응답으로 결합합니다.

상장 폐지, 비활성화, 현물 및 비암호화폐 시장은 제외됩니다.

***

### 엔드포인트

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

### 전체 URL

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

***

### 인증

인증이 필요하지 않습니다.

이 엔드포인트는 공개적으로 접근 가능하며 다음이 필요하지 않습니다:

* API 키
* 요청 서명
* 로그인 자격 증명
* 인증 토큰
* 사용자 지정 요청 헤더

***

### 쿼리 매개변수

이 엔드포인트는 쿼리 매개변수가 필요하지 않습니다.

***

### 시장 범위

이 엔드포인트는 CoinGecko 연동을 위해 BBX가 지원하는 활성 암호화폐 무기한 선물 시장을 반환합니다.

다음 상품은 제외됩니다:

* 상장 폐지되었거나 비활성화된 계약
* 현물 시장
* 토큰화 주식 및 주식 선물
* ETF 및 지수
* 원자재
* 기타 비암호화 자산

***

### 예시 요청

```bash
curl -s \\
  'https://dex.bbx.com/fapi/market/v1/public/coingecko/contracts'
```

***

### 예시 응답

```json
[
  {
    "ticker_id": "BTC-USDT",
    "base_currency": "BTC",
    "target_currency": "USDT",
    "last_price": "67250.5",
    "base_volume": "1523.447",
    "target_volume": "102450321.88",
    "bid": "67249.8",
    "ask": "67251.2",
    "high": "68100.0",
    "low": "66300.0",
    "product_type": "무기한",
    "open_interest": "8452.331",
    "open_interest_usd": "568432100.55",
    "index_price": "67248.9",
    "index_name": "BTC-USDT",
    "index_currency": "USDT",
    "funding_rate": "0.0001",
    "next_funding_rate": "0.0001",
    "next_funding_rate_timestamp": 1721548800,
    "contract_type": "바닐라",
    "contract_price": "0.0001",
    "contract_price_currency": "USDT"
  }
]
```

> 위에 표시된 값은 예시입니다. 실시간 응답에는 현재 BBX 시장 데이터가 포함됩니다.

***

### 응답 필드

#### 시장 데이터

| 필드                | 유형  | 요구 사항 | 설명                                              |
| ----------------- | --- | ----- | ----------------------------------------------- |
| `ticker_id`       | 문자열 | 필수    | 다음의 계약 식별자 `BASE-TARGET` 형식이며, 예를 들면 `BTC-USDT` |
| `기초 통화`           | 문자열 | 필수    | 기초 자산 심볼                                        |
| `target_currency` | 문자열 | 필수    | 기초 또는 견적 자산 심볼                                  |
| `최신 가격`           | 문자열 | 필수    | 최근 체결가                                          |
| `base_volume`     | 문자열 | 필수    | 기초 자산 단위의 24시간 롤링 거래량                           |
| `target_volume`   | 문자열 | 필수    | 목표 통화 단위의 24시간 롤링 거래량                           |
| `매수 호가`           | 문자열 | 권장    | 현재 최고 매수 호가; 매수 측이 비어 있으면 생략됩니다                 |
| `매도 호가`           | 문자열 | 권장    | 현재 최저 매도 호가; 매도 측이 비어 있으면 생략됩니다                 |
| `고가`              | 문자열 | 권장    | 24시간 롤링 최고 거래 가격                                |
| `저가`              | 문자열 | 권장    | 24시간 롤링 최저 거래 가격                                |

#### 상품 정보

| 필드                | 유형  | 요구 사항 | 설명                                                |
| ----------------- | --- | ----- | ------------------------------------------------- |
| `상품 유형`           | 문자열 | 필수    | 상품 유형: `무기한` 또는 `선물`                              |
| `start_timestamp` | 정수  | 선택 사항 | 상품 시작 시간을 초 단위 Unix 타임스탬프로 표시하며, 사용할 수 없으면 생략됩니다  |
| `end_timestamp`   | 정수  | 선택 사항 | 상품 만료 시간을 초 단위 Unix 타임스탬프로 표시하며, 무기한 계약의 경우 생략됩니다 |

#### 미결제약정 및 지수 데이터

| 필드               | 유형  | 요구 사항 | 설명                                |
| ---------------- | --- | ----- | --------------------------------- |
| `미결제약정`          | 문자열 | 필수    | 기초 자산 단위의 양방향 미결제약정               |
| `USD 기준 미결제약정`   | 문자열 | 필수    | USD 기준 양방향 미결제약정                  |
| `지수 가격`          | 문자열 | 필수    | 현재 기초 지수 가격                       |
| `index_name`     | 문자열 | 권장    | 기초 지수의 이름 또는 식별자; 사용할 수 없으면 생략됩니다 |
| `index_currency` | 문자열 | 필수    | 기초 지수의 견적 통화                      |

#### 펀딩 데이터

| 필드            | 유형  | 요구 사항         | 설명                            |
| ------------- | --- | ------------- | ----------------------------- |
| `펀딩 비율`       | 문자열 | 무기한 계약의 경우 필수 | 현재 펀딩 비율                      |
| `다음 펀딩 비율`    | 문자열 | 무기한 계약의 경우 필수 | 다음 펀딩 구간의 펀딩 비율 값             |
| `다음 펀딩 타임스탬프` | 정수  | 무기한 계약의 경우 필수 | 초 단위 Unix 타임스탬프로 표시한 다음 펀딩 시각 |

#### 계약 사양

| 필드         | 유형  | 요구 사항 | 설명                                    |
| ---------- | --- | ----- | ------------------------------------- |
| `계약 유형`    | 문자열 | 필수    | `바닐라` 선형 계약의 경우 또는 `인버스` 코인 마진 계약의 경우 |
| `계약 가격`    | 문자열 | 필수    | 한 계약이 나타내는 계약 규모 또는 가격                |
| `계약 가격 통화` | 문자열 | 필수    | 계약이 가격 책정되는 통화                        |

***

### 페어 명명

계약 식별자는 다음 형식을 사용합니다:

```
BASE-TARGET
```

예시:

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

***

### 숫자 값

가격, 거래량, 미결제약정 값 및 펀딩 비율은 부동소수점 정밀도 손실을 피하기 위해 문자열로 반환됩니다.

예:

```json
{
  "last_price": "67250.5",
  "open_interest": "8452.331",
  "funding_rate": "0.0001"
}
```

타임스탬프는 JSON 정수로 반환됩니다.

***

### 타임스탬프 단위

다음 필드는 초 단위 Unix 타임스탬프를 사용합니다:

```
start_timestamp
end_timestamp
다음 펀딩 타임스탬프
```

무기한 계약은 다음을 생략할 수 있습니다 `start_timestamp` 및 `end_timestamp`.

***

### 미결제약정 산정 방식

이 엔드포인트는 CoinGecko의 양방향 산정 방식을 사용하여 미결제약정을 보고합니다.

양방향 미결제약정은 롱과 숏 미결제 포지션의 합계를 나타냅니다.

API는 다음을 제공합니다:

* `미결제약정` 기초 자산 단위로
* `USD 기준 미결제약정` USD로

***

### 펀딩 비율 형식

펀딩 비율은 소수 값으로 반환되며 연환산되지 않습니다.

예:

```
0.0001 = 0.01%
```

해당 `다음 펀딩 타임스탬프` 해당 필드는 다음 펀딩 구간의 시작을 나타냅니다.

***

### 데이터 가용성

예를 들어 다음과 같은 권장 필드는 `매수 호가`, `매도 호가`, `고가`, `저가`, 그리고 `index_name` 해당 시장 데이터가 없을 경우 생략될 수 있습니다.

필수 필드는 엔드포인트가 반환하는 각 활성 시장에 포함됩니다.

성공 응답은 래퍼 외피 없이 일반 JSON으로 반환됩니다.