> 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/to.md).

# 契約と契約仕様

がサポートする有効な暗号資産無期限先物市場を返します **BBX DEX** CoinGeckoデリバティブ取引所統合向けです。

このエンドポイントは CoinGecko の **コントラクト** と **コントラクト仕様** 要件を1つのレスポンスにまとめます。

上場廃止、無効化済み、スポット、および暗号資産以外の市場は除外されます。

***

### エンドポイント

```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": "Perpetual",
    "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": "Vanilla",
    "contract_price": "0.0001",
    "contract_price_currency": "USDT"
  }
]
```

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

***

### レスポンス項目

#### 市場データ

| 項目                | 型   | 要件 | 説明                                    |
| ----------------- | --- | -- | ------------------------------------- |
| `ticker_id`       | 文字列 | 必須 | 契約識別子 `BASE-TARGET` 形式、例えば `BTC-USDT` |
| `base_currency`   | 文字列 | 必須 | ベース資産のシンボル                            |
| `target_currency` | 文字列 | 必須 | 対象通貨またはクォート資産のシンボル                    |
| `last_price`      | 文字列 | 必須 | 最新の約定価格                               |
| `base_volume`     | 文字列 | 必須 | ベース資産単位での直近24時間取引高                    |
| `target_volume`   | 文字列 | 必須 | 対象通貨単位での直近24時間取引高                     |
| `bid`             | 文字列 | 推奨 | 現在の最高買い気配価格。買い側が空の場合は省略されます           |
| `ask`             | 文字列 | 推奨 | 現在の最低売り気配価格。売り側が空の場合は省略されます           |
| `high`            | 文字列 | 推奨 | 直近24時間の最高取引価格                         |
| `low`             | 文字列 | 推奨 | 直近24時間の最低取引価格                         |

#### 商品情報

| 項目                | 型   | 要件 | 説明                                            |
| ----------------- | --- | -- | --------------------------------------------- |
| `product_type`    | 文字列 | 必須 | 商品タイプ: `無期限` または `先物`                         |
| `start_timestamp` | 整数  | 任意 | 商品の開始時刻を秒単位のUnixタイムスタンプで表したもの。利用できない場合は省略されます |
| `end_timestamp`   | 整数  | 任意 | 商品の満期時刻を秒単位のUnixタイムスタンプで表したもの。無期限契約では省略されます   |

#### 建玉とインデックスデータ

| 項目                  | 型   | 要件 | 説明                                 |
| ------------------- | --- | -- | ---------------------------------- |
| `open_interest`     | 文字列 | 必須 | ベース資産単位での両建て建玉                     |
| `open_interest_usd` | 文字列 | 必須 | USD建ての両建て建玉                        |
| `index_price`       | 文字列 | 必須 | 現在の原資産インデックス価格                     |
| `index_name`        | 文字列 | 推奨 | 原資産インデックスの名称または識別子。利用できない場合は省略されます |
| `index_currency`    | 文字列 | 必須 | 原資産インデックスのクォート通貨                   |

#### 資金調達データ

| 項目                            | 型   | 要件        | 説明                             |
| ----------------------------- | --- | --------- | ------------------------------ |
| `funding_rate`                | 文字列 | 無期限向けでは必須 | 現在のファンディングレート                  |
| `next_funding_rate`           | 文字列 | 無期限向けでは必須 | 次の資金調達間隔の資金調達率値                |
| `next_funding_rate_timestamp` | 整数  | 無期限向けでは必須 | 次回資金調達時刻を秒単位のUnixタイムスタンプで表したもの |

#### 契約仕様

| 項目                        | 型   | 要件 | 説明                               |
| ------------------------- | --- | -- | -------------------------------- |
| `contract_type`           | 文字列 | 必須 | `バニラ` 線形契約の場合は `インバース` コイン建て契約向け |
| `contract_price`          | 文字列 | 必須 | 1契約で表される契約サイズまたは価格               |
| `contract_price_currency` | 文字列 | 必須 | 契約の価格通貨                          |

***

### ペア命名規則

契約識別子は次の形式を使用します:

```
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
next_funding_rate_timestamp
```

無期限契約では省略される場合があります `start_timestamp` と `end_timestamp`.

***

### 建玉の算出方法

このエンドポイントは、CoinGeckoの両建て方式を用いて建玉を返します。

両建て建玉は、ロングとショートの未決済ポジションを合算したものです。

APIは以下を提供します:

* `open_interest` ベース資産単位で
* `open_interest_usd` USD建てで

***

### 資金調達率の形式

資金調達率は小数値で返され、年率換算されません。

例:

```
0.0001 = 0.01%
```

その `next_funding_rate_timestamp` このフィールドは次の資金調達間隔の開始を示します。

***

### データの利用可否

次のような推奨フィールドは `bid`, `ask`, `high`, `low`、および `index_name` 対応する市場データが利用できない場合は省略されることがあります。

必須フィールドは、このエンドポイントが返すすべての有効市場に含まれます。

成功レスポンスは、ラッパーエンベロープなしのプレーンJSONとして返されます。