獲取交易對信息

GET

/az/spot/public/symbol

限流規則

1.獲取單個交易對：10/s/ip

2.獲取多個交易對：10/s/ip

---

過濾器

過濾器，即Filter，定義了一系列交易規則。針對不同的領域或者實體有不同的過濾器，這裏主要介紹針對symbol這個實體的過濾器。 對於symbol來說，有兩種過濾器，一種是全局過濾器，一種是針對某個交易對定製的過濾器。

---

價格過濾器 PRICE FILTER

價格過濾器 用於檢測訂單中 price 參數的合法性。包含以下三個部分:

1.min 定義了訂單中price允許的最小值

2.max 定義了訂單中price允許的最大值

3.tickSize 定義了訂單中price的步進間隔，即price必須等於minPrice+(tickSize的整數倍)

以上每一項均可爲null，爲null時代表這一項不再做限制

邏輯僞代碼如下:

• price >= min
• price <= max
• (price-minPrice) % tickSize == 0

---

數量過濾器  QUANTITY FILTER

其邏輯和PRICE FILTER 類似，不過針對的是訂單數量。

其內部包含三個部分

1.min 允許的最小值

2.max 允許的最大值

3.tickSize  步進間隔，即quantity必須等於minQuantity+(tickSize的整數倍)

以上每一項均可爲null，爲null時代表這一項不再做限制

邏輯僞代碼如下:

• quantity>= min
• quantity<= max
• (quantity-minQuantity)% tickSize == 0

---

金額過濾器 QUOTE_QTY FILTER

對於訂單的金額做限制

其內部定義了min允許的最小值

當min爲null時，訂單不做限制

否則限制規則如下：

1.對於限價LIMIT類型的訂單，需滿足 price*quantity>=min

2.對於市價MARKET類型並且是購買類型(orderSide=BUY)訂單，需滿足quoteQty>=min,(quoteQty,市價按金額下單時必填的金額)

---

開盤保護過濾器 PROTECTION_ONLINE FILTER

對處於開盤之後指定的時間範圍內，對於限價類型的訂單的價格進行限制

該過濾器內部定義了最大價格倍數(maxPriceMultiple)，持續時間(durationSeconds)。

限制邏輯:當處於交易對開盤後durationSeconds時間範圍內，訂單類型爲限價類（LIMIT）的訂單

須滿足訂單價格price<=openPrice*maxPriceMultiple,纔會通過（openPrice爲開盤價）。

其他類型的訂單或者不在開盤時間範圍內的訂單不做限制。

對於maxPriceMultiple,durationSeconds均可爲null,爲null時，不做開盤保護限制。

---

限價保護過濾器 PROTECTION_LIMIT FILTER

對於訂單類型(orderType)爲LIMIT(限價) 類型的訂單具有價格保護限制，包含以下四個部分

1.buyMaxDeviation: 買單最大偏離度，根據該值和最新成交價確定買單價格最小值

2.buyPriceLimitCoefficient: 買單限制係數，根據該值和最新成交價確定買單價格最大值

3.sellMaxDeviation: 賣單最大偏離度，根據該值和最新成交價確定賣單價格最大值

4.sellPriceLimitCoefficient: 賣單限制係數，根據該值和最新成交價確定賣單價格最小值

若沒有最新成交價則不做限制，或者以上參數爲null,則對應方向類型訂單不做限制

爲了通過限價保護，訂單price必須滿足以下條件(latestPrice爲最新成交價)

買單: price >= latestPrice-latestPrice*buyMaxDeviation  && price <= latestPrice+latestPrice*buyPriceLimitCoefficient

賣單: price <= latestPrice+latestPrice*sellMaxDeviation  && price >= latestPrice-latestPrice*sellPriceLimitCoefficient

---

市價保護過濾器 PROTECTION_MARKET FILTER

對於訂單類型爲MARKET的訂單具有價格限制保護機制，其內部規定了maxDeviation最大偏差率。

對於市價類型訂單，市場價格須滿足以下條件，訂單纔會通過(sellBestPrice  賣一價格，buyBestPrice 買一價格，latestPrice 最新成交價,這些數據均通過歷史成交數據獲得)

買單: latestPrice + latestPrice* maxDeviation >= sellBestPrice 

賣單: latestPrice - latestPrice* maxDeviation <= buyBestPrice

對於以上情況maxDeviation，latestPrice，sellBestPrice ，buyBestPrice

均有可能爲空或者沒有最新成交價，買一價格，賣一價格，則不做限制

請求參數

參數	類型	是否必須	默認值	描述	取值範圍
symbol	string	false		交易對 eg:btc_usdt
symbols	string	false		交易對集合，優先級高於symbol。 eg: btc_usdt,eth_usdt
version	string	false		版本號,當請求版本號與響應內容版本一致時，不返回清單，減少IO eg: 2e14d2cd5czcb2c2af2c1db65078d075
tags	string	false		標籤集合,逗號分割，當前僅支持 spot
type	string	false	normal	交易對類型, eg: normal/nft

Response

{
  "rc": 0,
  "mc": "SUCCESS",
  "ma": [],
  "result": {
    "time": 1662444177871,                          //時間
    "version": "7cd2cfab0dc979339f1de904bd90c9cb",  //內容版本
    "symbols": [                                    //交易對清單
      {
        "id": 614,                                  //ID
        "symbol": "btc_usdt",                       //交易對
        "displayName": "BTC/USDT",                  //展示名
        "displayNames": {                           //i18n展示名(鍵=語言碼,en恆在)
          "en": "BTC/USDT"
        },
        "type": "normal",                           //交易對類型
        "state": "ONLINE",                          //交易對狀態[ONLINE=上線的;OFFLINE=下線的,DELISTED=退市]
        "stateTime": 1662444177871,                 //狀態時間(ms)
        "tradingEnabled": true,                     //啓用交易
        "openapiEnabled": true,                     //啓用OPENAPI
        "nextStateTime": null,                      //下一個狀態時間
        "nextState": null,                          //下一個狀態
        "depthMergePrecision": 5,                   //深度合併精度
        "baseCurrency": "btc",                      //標的資產
        "baseCurrencyPrecision": 5,                 //標的資產精度
        "baseCurrencyId": 2,                        //標的資產ID
        "baseCurrencyLogo": "https://.../btc.png",  //標的資產Logo
        "quoteCurrency": "usdt",                    //報價資產
        "quoteCurrencyPrecision": 6,                //報價資產精度
        "quoteCurrencyId": 11,                      //報價資產ID
        "pricePrecision": 4,                        //交易價格精度
        "quantityPrecision": 6,                     //交易數量精度
        "takerFeeRate": "0.001",                    //喫單手續費率(string)
        "makerFeeRate": "0.002",                    //掛單手續費率(string)
        "isBlack": false,                           //當前builder是否屏蔽
        "isRfq": false,                             //是否RFQ交易對
        "chainRelation": [                          //標的幣種鏈地址
          {
            "chainId": 1,
            "contract": "0x..."
          }
        ],
        "orderTypes": [                             //訂單類型[LIMIT=限價單;MARKET=市價單]
          "LIMIT",
          "MARKET"
        ],
        "timeInForces": [                           //有效方式[GTC=成交爲止,一直有效; IOC=無法立即成交(喫單)的部分就撤銷; FOK=無法全部立即成交就撤銷; GTX=無法成爲掛單方就撤銷]
          "GTC",
          "FOK",
          "IOC",
          "GTX"
        ],
        "displayWeight": 1,                         //展示權重，越大越靠前
        "displayLevel": "FULL",                     //展示級別,[FULL=完全展示,SEARCH=搜索展示,DIRECT=直達展示,NONE=不展示]
        "plates": [],                               //所屬板塊  eg:22,23,24
        "filters": [                                //過濾器
          {
            "filter": "PROTECTION_LIMIT",
            "buyMaxDeviation": "0.8"
            "sellMaxDeviation": "0.8"
          },
          {
            "filter": "PROTECTION_MARKET",
            "maxDeviation": "0.1"
          },
          {
            "filter": "PROTECTION_ONLINE",
            "durationSeconds": "300",
            "maxPriceMultiple": "5"
          },
          {
            "filter": "PRICE",
            "min": null,
            "max": null,
            "tickSize": null
          },
          {
            "filter": "QUANTITY",
            "min": null,
            "max": null,
            "tickSize": null
          },
          {
            "filter": "QUOTE_QTY",
            "min": null
          },
       ]
      }
    ]
  }
}