# 现货交易

#### 公共 <a href="#gong-gong" id="gong-gong"></a>

**安全类型: None**

公共下方的接口不需要API-key或者签名就能自由访问

#### 测试连接 <a href="#ce-shi-lian-jie" id="ce-shi-lian-jie"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/ping`

测试REST API的连通性 **Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/TestConnectivity.java`

200 连接正常<a class="button secondary">复制</a>

```
{}
```

#### 服务器时间 <a href="#fu-wu-qi-shi-jian" id="fu-wu-qi-shi-jian"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/time`

服务器时间 **Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/CheckServerTime.java`

200 获取服务器时间成功<a class="button secondary">复制</a>

```
{
    "timezone": "GMT+08:00",
    "serverTime": 1595563624731
}
```

#### 币对列表 <a href="#bi-dui-lie-biao" id="bi-dui-lie-biao"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/symbols`

市场支持的币对集合 **Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/PairsList.java`

200 获取币对列表成功<a class="button secondary">复制</a>

```
{
    "symbols": [
        {
            "quantityPrecision": 3,
            "symbol": "sccadai",
            "pricePrecision": 6,
            "baseAsset": "SCCA",
            "quoteAsset": "DAI"
        },
        {
            "quantityPrecision": 8,
            "symbol": "btcusdt",
            "pricePrecision": 2,
            "baseAsset": "BTC",
            "quoteAsset": "USDT"
        },
        {
            "quantityPrecision": 3,
            "symbol": "bchusdt",
            "pricePrecision": 2,
            "baseAsset": "BCH",
            "quoteAsset": "USDT"
        },
        {
            "quantityPrecision": 2,
            "symbol": "etcusdt",
            "pricePrecision": 2,
            "baseAsset": "ETC",
            "quoteAsset": "USDT"
        },
        {
            "quantityPrecision": 2,
            "symbol": "ltcbtc",
            "pricePrecision": 6,
            "baseAsset": "LTC",
            "quoteAsset": "BTC"
        }
    ]
}
```

**Response:**

名称类型例子描述

symbol

string

`BTCUSDT`

币对名称

baseAsset

string

`BTC`

base货币

quoteAsset

string

`USDT`

计价货币

pricePrecision

integer

`2`

价格精度

quantityPrecision

integer

`6`

数量精度

#### 行情 <a href="#hang-qing" id="hang-qing"></a>

**安全类型: None**

行情下方的接口不需要API-Key或者签名就能自由访问

#### 订单薄 <a href="#ding-dan-bo" id="ding-dan-bo"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/depth`

市场订单薄深度信息 **Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/Depth.java`

**Query Parameters**

NameTypeDescription

limit\*

integer

默认100; 最大100

symbol\*

string

币对名称 E.g. BTCUSDT

200 成功获取深度信息<a class="button secondary">复制</a>

```
{
  "bids": [
    [
      "3.90000000",   // 价格
      "431.00000000"  // 数量
    ],
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "asks": [
    [
      "4.00000200",  // 价格
      "12.00000000"  // 数量
    ],
    [
      "5.10000000",
      "28.00000000"
    ]
  ]
}
```

**Response:**

名称类型例子描述

time

long

`1595563624731`

当前时间(Unix Timestamp, 毫秒ms)

bids

list

如下

订单薄买盘信息

asks

list

如下

订单薄卖盘信息

bids和asks所对应的信息代表了订单薄的所有价格以及价格对应的数量的信息, 由最优价格从上倒下排列

名称类型例子描述

' '

float

`131.1`

价格

' '

float

`2.3`

当前价格对应的数量

#### 行情ticker <a href="#hang-qing-ticker" id="hang-qing-ticker"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/ticker`

24小时价格变化数据 **Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/Ticker.java`

**Query Parameters**

NameTypeDescription

symbol\*

string

币对名称 E.g. `BTCUSDT`

200 成功获取ticker信息<a class="button secondary">复制</a>

```
{
    "high": "9279.0301",
    "vol": "1302",
    "last": "9200",
    "low": "9279.0301",
    "rose": "0",
    "time": 1595563624731
}
```

**Response:**

名称类型例子描述

time

long

`1595563624731`

时间戳

high

float

`9900`

最高价

low

float

`8800.34`

最低价

last

float

`8900`

最新价

vol

float

`4999`

交易量

open

float

`5000`

开盘价

#### 最近成交 <a href="#zui-jin-cheng-jiao" id="zui-jin-cheng-jiao"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/trades`

**Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/RecentTradesList.java`\\

**Query Parameters**

NameTypeDescription

symbol\*

string

币对名称 E.g. `BTCUSDT`

limit\*

string

默认100; 最大1000

200<a class="button secondary">复制</a>

```
{
    "list":[
        {
            "price":"3.00000100",
            "qty":"11.00000000",
            "time":1499865549590,
            "side":"BUY"
        }
    ]
}
```

**Response:**

名称类型例子描述

`price`

float

`0.055`

交易价格

`time`

long

`1537797044116`

当前Unix时间戳，毫秒(ms)

`qty`

float

`5`

数量（张数）

`side`

string

`BUY/SELL`

主动单方向

#### K线/蜡烛图数据 <a href="#k-xian-la-zhu-tu-shu-ju" id="k-xian-la-zhu-tu-shu-ju"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/klines`

**Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/KlineCandlestickData.java`\\

**Query Parameters**

NameTypeDescription

symbol\*

string

币对名称 E.g. `BTCUSDT`

interval\*

string

k线图区间, 可识别发送的值为： `1min`,`5min`,`15min`,`30min`,`60min`,`1day`,`1week`,`1month`（min=分钟，h=小时,day=天，week=星期，month=月）

limit\*

integer

默认100; 最大300

200<a class="button secondary">复制</a>

```
[
    {
        "high": "6228.77",
        "vol": "111",
        "low": "6228.77",
        "idx": 1594640340,
        "close": "6228.77",
        "open": "6228.77"
    },
    {
        "high": "6228.77",
        "vol": "222",
        "low": "6228.77",
        "idx": 1587632160,
        "close": "6228.77",
        "open": "6228.77"
    },
    {
        "high": "6228.77",
        "vol": "333",
        "low": "6228.77",
        "idx": 1587632100,
        "close": "6228.77",
        "open": "6228.77"
    }
]
```

**Response:**

名称类型例子描述

`idx`

long

`1538728740000`

开始时间戳，毫秒（ms）

`open`

float

`36.00000`

开盘价

`close`

float

`33.00000`

收盘价

`high`

float

`36.00000`

最高价

`low`

float

`30.00000`

最低价

`vol`

float

`2456.111`

成交量

#### 交易 <a href="#jiao-yi" id="jiao-yi"></a>

**安全类型: TRADE**

交易下方的接口都需要签名和API-key验证

#### 创建新订单 <a href="#chuang-jian-xin-ding-dan" id="chuang-jian-xin-ding-dan"></a>

`POST` `https://openapi.aivora.com/spot/open/sapi/v1/order`

**Demo:** \&#xNAN;**`https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/NewOrder.java`** **限速规则: 100次/2s**

**Headers**

NameTypeDescription

X-CH-SIGN\*

string

签名

X-CH-APIKEY\*

string

您的API-key

X-CH-TS\*

integer

时间戳

**Request Body**

NameTypeDescription

symbol\*

string

币对名称 E.g. `BTCUSDT`

volume\*

number

订单数量

side\*

string

订单方向, `BUY/SELL`

type\*

string

订单类型, `LIMIT/MARKET`

price

number

订单价格, 对于`LIMIT`订单必须发送

newClientOrderId

string

客户端订单标识

recvWindow

integer

时间窗口

200 发送新订单成功<a class="button secondary">复制</a>

```
{
    'symbol': 'LXTUSDT', 
    'orderId': '150695552109032492', 
    'clientOrderId': '157371322565051',
    'transactTime': '1573713225668', 
    'price': '0.005452', 
    'origQty': '110', 
    'executedQty': '0', 
    'status': 'NEW',
    'type': 'LIMIT', 
    'side': 'SELL'
}
```

**Response:**

名称类型例子描述

`orderId`

long

`150695552109032492`

订单ID（系统生成）

`clientOrderId`

string

`213443`

订单ID（自己发送的）

`symbol`

string

`BTCUSDT`

币对名称

`transactTime`

integer

`1273774892913`

订单创建时间

`price`

float

`4765.29`

订单价格

`origQty`

float

`1.01`

订单数量

`executedQty`

float

`1.01`

已经成交订单数量

`type`

string

`LIMIT`

订单类型`LIMIT`(限价)`MARKET`（市价）

`side`

string

`BUY`

订单方向。可能出现的值只能为：`BUY`（买入做多） 和 `SELL`（卖出做空）

`status`

string

`NEW`

订单状态。可能出现的值为：`NEW`(新订单，无成交)、`PARTIALLY_FILLED`（部分成交）、`FILLED`（全部成交）、`CANCELED`（已取消）和`REJECTED`（订单被拒绝）.

#### 创建测试订单 <a href="#chuang-jian-ce-shi-ding-dan" id="chuang-jian-ce-shi-ding-dan"></a>

`POST` `https://openapi.aivora.com/spot/open/sapi/v1/order/test`

**Demo:** \&#xNAN;**`https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/TestNewOrder.java`** 创建和验证新订单, 但不会送入撮合引擎

**Headers**

NameTypeDescription

X-CH-SIGN\*

string

签名

X-CH-APIKEY\*

string

您的API-key

X-CH-TS\*

integer

时间戳

**Request Body**

NameTypeDescription

recvWindow

integer

时间窗口

symbol\*

string

币对名称 E.g. `BTCUSDT`

volume\*

number

订单数量

side\*

string

订单方向, `BUY/SELL`

type\*

string

订单类型, `LIMIT/MARKET`

price

number

订单价格, 对于`LIMIT`订单必须发送

newClientOrderId

string

客户端订单标识

200 创建测试订单成功<a class="button secondary">复制</a>

```
{}
```

#### 批量下单 <a href="#pi-liang-xia-dan" id="pi-liang-xia-dan"></a>

`POST` `https://openapi.aivora.com/spot/open/sapi/v1/batchOrders`

**Demo:** \&#xNAN;**`https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/BatchOrders.java`** **限速规则: 50次/2s 一个批量最多10个订单**

**Headers**

NameTypeDescription

X-CH-SIGN\*

string

签名

X-CH-APIKEY\*

string

您的API-key

X-CH-TS\*

integer

时间戳

**Request Body**

NameTypeDescription

orders\*

array

批量订单信息 最多10条

symbol\*

string

币对名称 E.g. `BTCUSDT`

200<a class="button secondary">复制</a>

```
{
    "ids": [
        165964665990709251,
        165964665990709252,
        165964665990709253
    ]
}
```

**Resquest `orders` field:**

名称类型例子描述

`price`

folat

1000

价格

`volume`

folat

20.1

数量

`side`

string

`BUY/SELL`

方向

`batchType`

string

`LIMIT/MARKET`

类型

#### 订单查询 <a href="#ding-dan-cha-xun" id="ding-dan-cha-xun"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/order`

**Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/QueryOrder.java` **限速规则: 20次/2s**

**Query Parameters**

NameTypeDescription

orderId\*

string

订单id

newClientOrderId

string

客户端订单标识

symbol\*

string

币对名称 E.g. `BTCUSDT`

**Headers**

NameTypeDescription

X-CH-SIGN\*

string

签名

X-CH-APIKEY\*

string

您的API-key

X-CH-TS\*

integer

时间戳

200<a class="button secondary">复制</a>

```
{
    'orderId': '499890200602846976', 
    'clientOrderId': '157432755564968', 
    'symbol': 'BHTUSDT', 
    'price': '0.01', 
    'origQty': '50', 
    'executedQty': '0', 
    'avgPrice': '0', 
    'status': 'NEW', 
    'type': 'LIMIT', 
    'side': 'BUY', 
    'transactTime': '1574327555669'
}
```

**Response:**

名称类型例子描述

`orderId`

long

`150695552109032492`

订单ID（系统生成）

`clientOrderId`

string

`213443`

订单ID（自己发送的）

`symbol`

string

`BTCUSDT`

币对名称

`price`

float

`4765.29`

订单价格

`origQty`

float

`1.01`

订单数量

`executedQty`

float

`1.01`

已经成交订单数量

`avgPrice`

float

`4754.24`

订单已经成交的平均价格

`type`

string

`LIMIT`

订单类型。可能出现的值只能为:`LIMIT`(限价)和`MARKET`（市价）

`side`

string

`BUY`

订单方向。可能出现的值只能为：`BUY`（买入做多） 和 `SELL`（卖出做空）

`status`

string

`NEW`

订单状态。可能出现的值为：`NEW`(新订单，无成交)、`PARTIALLY_FILLED`（部分成交）、`FILLED`（全部成交）、`CANCELED`（已取消）和`REJECTED`（订单被拒绝）.

#### 撤销订单 <a href="#che-xiao-ding-dan" id="che-xiao-ding-dan"></a>

`POST` `https://openapi.aivora.com/spot/open/sapi/v1/cancel`

**Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/CancelOrder.java` **限速规则: 100次/2s**

**Headers**

NameTypeDescription

X-CH-SIGN\*

string

签名

X-CH-APIKEY\*

string

您的API-key

X-CH-TS\*

integer

时间戳

**Request Body**

NameTypeDescription

orderId\*

string

订单id

newClientOrderId

string

客户端订单标识

symbol\*

string

币对名称 E.g. `BTCUSDT`

200 撤销订单成功<a class="button secondary">复制</a>

```
{
    'symbol': 'BHTUSDT', 
    'clientOrderId': '0', 
    'orderId': '499890200602846976', 
    'status': 'CANCELED'
}
```

**Response:**

名称类型例子描述

`orderId`

long

`150695552109032492`

订单ID（系统生成

`clientOrderId`

string

`213443`

订单ID（自己发送的）

`symbol`

string

`BHTUSDT`

币对名称

`status`

string

`NEW`

订单状态。可能出现的值为：`NEW`(新订单，无成交)、`PARTIALLY_FILLED`（部分成交）、`FILLED`（全部成交）、`CANCELED`（已取消）和`REJECTED`（订单被拒绝）

#### 批量撤销订单 <a href="#pi-liang-che-xiao-ding-dan" id="pi-liang-che-xiao-ding-dan"></a>

`POST` `https://openapi.aivora.com/spot/open/sapi/v1/batchCancel`

**Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/BatchCancelOrders.java` **限速规则: 50次/2s 一次批量最多10个订单**

**Headers**

NameTypeDescription

X-CH-SIGN\*

string

签名

X-CH-APIKEY\*

string

您的API-key

X-CH-TS\*

integer

时间戳

**Request Body**

NameTypeDescription

symbol\*

string

币对名称 E.g. `BTCUSDT`

orderIds\*

array

要取消的订单id集合 `[123,456]`

200<a class="button secondary">复制</a>

```
{
    "success": [
        165964665990709251,
        165964665990709252,
        165964665990709253
    ],
    "failed": [ //取消失败一般是因为订单不存在或订单状态已经到终态
        165964665990709250  
    ]
}
```

#### 当前订单 <a href="#dang-qian-ding-dan" id="dang-qian-ding-dan"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/openOrders`

**Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/CurrentOpenOrders.java` **限速规则: 20次/2s**

**Query Parameters**

NameTypeDescription

symbol\*

string

币对名称 E.g. `BTCUSDT`

limit\*

integer

默认100; 最大1000

**Headers**

NameTypeDescription

X-CH-SIGN\*

string

签名

X-CH-APIKEY\*

string

您的API-key

X-CH-TS\*

integer

时间戳

200<a class="button secondary">复制</a>

```
[
    {
        'orderId': '499902955766523648', 
        'symbol': 'BHTUSDT', 
        'price': '0.01', 
        'origQty': '50', 
        'executedQty': '0', 
        'avgPrice': '0', 
        'status': 'NEW', 
        'type': 'LIMIT', 
        'side': 'BUY', 
        'time': '1574329076202'
        },...
]
```

**Response:**

名称类型例子描述

`orderId`

long

`150695552109032492`

订单ID（系统生成）

`clientOrderId`

string

`213443`

订单ID（自己发送的）

`symbol`

string

`BTCUSDT`

币对名称

`price`

float

`4765.29`

订单价格

`origQty`

float

`1.01`

订单数量

`executedQty`

float

`1.01`

已经成交订单数量

`avgPrice`

float

`4754.24`

订单已经成交的平均价格

`type`

string

`LIMIT`

订单类型。可能出现的值只能为:`LIMIT`(限价)和`MARKET`（市价）

`side`

string

`BUY`

订单方向。可能出现的值只能为：`BUY`（买入做多） 和 `SELL`（卖出做空）

`status`

string

`NEW`

订单状态。可能出现的值为：`NEW`(新订单，无成交)、`PARTIALLY_FILLED`（部分成交）、`FILLED`（全部成交）、`CANCELED`（已取消）和`REJECTED`（订单被拒绝）.

#### 交易记录 <a href="#jiao-yi-ji-lu" id="jiao-yi-ji-lu"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/myTrades`

**Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/Trades.java` **限速规则: 20次/2s**

**Query Parameters**

NameTypeDescription

symbol\*

string

币对名称 E.g. `BTCUSDT`

limit\*

string

默认100; 最大1000

fromId\*

integer

从这个tradeId开始检索

**Headers**

NameTypeDescription

X-CH-SIGN\*

string

签名

X-CH-APIKEY\*

string

您的API-key

X-CH-TS\*

integer

时间戳

200<a class="button secondary">复制</a>

```
[
  {
    "symbol": "ETHBTC",
    "id": 100211,
    "bidId": 150695552109032492,
    "askId": 150695552109032493,
    "price": "4.00000100",
    "qty": "12.00000000",
    "time": 1499865549590,
    "isBuyer": true,
    "isMaker": false,
    "feeCoin": "ETH",
    "fee":"0.001"
  },...
]
```

**Response:**

名称类型例子描述

`symbol`

string

`ETHBTC`

币种名称(交易对)

`id`

integer

`28457`

交易ID

`bidId`

long

`150695552109032492`

买方订单ID

`askId`

long

`150695552109032493`

卖方订单ID

`price`

integer

`4.01`

交易时间戳

`qty`

float

`12`

交易数量

`time`

number

`1499865549590`

交易时间戳

`isBuyer`

bool

`true`

`true`= Buyer `false`= Seller

`isMaker`

bool

`false`

`true`=Maker `false`=Taker

`feeCoin`

string

`ETH`

交易手续费币种

`fee`

number

`0.001`

交易手续费

#### 账户 <a href="#zhang-hu" id="zhang-hu"></a>

**安全类型: USER\_DATA**

账户下方的接口都需要签名和API-key验证

#### 账户信息 <a href="#zhang-hu-xin-xi" id="zhang-hu-xin-xi"></a>

`GET` `https://openapi.aivora.com/spot/open/sapi/v1/account`

**Demo:** `https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/spot/AccountInformation.java` **限速规则: 20次/2s**

**Headers**

NameTypeDescription

X-CH-SIGN\*

string

签名

X-CH-APIKEY\*

string

您的API-key

X-CH-TS\*

integer

时间戳

200 获取账户信息成功<a class="button secondary">复制</a>

```
{
    'balances': 
        [
            {
                'asset': 'BTC', 
                'free': '0', 
                'locked': '0'
                }, 
            {
                'asset': 'ETH', 
                'free': '0', 
                'locked': '0'
                },...
        ]
}
```

**Response:**

名称类型描述

`balances`

`[]`

余额集合

`balances` field:

名称类型例子描述

`asset`

string

`USDT`

币种名称

`free`

float

1000.30

可用

`locked`

float

400

冻结


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kaisensei34.gitbook.io/aivora-docs/xian-huo-jiao-yi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.