API 常見問題

2018-06-05 09:38

最後更新日期:2025 年 1 月 13 日

API 文件 | API 開源程式庫和範例 

有什麼限制?

總覽

有三種不同限制,所有限制歲時都可能更改:

  1. 硬限制
  2. ML(機器學習)限制
  3. WAF(網路應用程式防火牆)限制

硬限制

  • 每分鐘 6,000 請求權重 (請注意,這不一定和 6,000 個請求相同)
  • 每 10 秒 100 筆訂單
  • 每 24 小時 200,000 筆訂單

我們的硬限制表列在 [/api/v3/exchangeInfo] 端點。

機器學習限制

交易行為是以一般用戶為標準進行評估。如果您偏離太遠,您會被限用一段時間,從 5 分鐘到 3 天不等。

假設您有交易濫用的分數。在下列情況下,您的分數會增加: 

  • 您在訂單簿上重複對最佳買價 / 賣價「抬價」或「搶先交易」。
  • 您快速發送訂單建立和取消的委託卻沒有執行交易。
  • 您的「交易率」偏低。「交易率」的定義為您的交易數除以 24 小時期間的訂單建立和取消總數(交易數/(訂單 + 取消訂單))。
  • 您的「權重」偏低。「權重」的定義為您的總交易量除以 24 小時期間的訂單建立和取消總數(總交易量/(訂單 + 取消訂單))。
  • 如果交易對以 BNB 為基礎或報價資產,您的濫用分數將會倍增。

我們將不會提供比上方更具體的資訊。請透過嘗試錯誤來達成理想的交易模式,或是和其他 API 用戶討論最佳行為。

網路應用程式防火牆限制

雖然我們沒有提供 WAF 規則的精確詳情,但是如果您收到 HTTP 403 錯誤,就表示您違規了。這極有可能是在 5 分鐘內請求過多所導致。然而,如果您在傳送可視為惡意行為的請求,也可能導致更長時間的禁制。

如果我超過限制,我的帳戶、API 金鑰或 IP 地址等會受到限制嗎?

就硬限制,超過每分鐘的請求權重上限 (目前為 6,000) 將導致 IP 被禁止。訂單限制(目前為每秒 10 筆訂單和每 24 小時 200,000 筆訂單)則取決於帳戶。如果超過訂單限制,用戶也將被禁止在網站上 (或者我們其他應用程式上) 建立新的訂單。

機器學習限制對帳戶施加。如果您受到機器學習系統限制,您可以使用 [/sapi/v1/帳戶/狀態] 端點來檢查原因和持續時間 (在我們的 API 文件中列出)。

網路應用程式防火牆限制僅會透過 IP 實施。通常,WAF 禁令的持續時間為 5 分鐘。然而,如果伺服器將用戶請求視為惡意,時間就會延長。

我因為超過限制而受到限制,但是我修正了我的密碼。你們會提早解除禁令嗎?

不可以。您必須耐心等待禁令結束。

為什麼我在使用 API 時收到 HTTP 403 錯誤?

您已違反 WAF(網路應用程式防火牆)規則,很可能是因為您違反速率限制或是發送惡意請求(如本文件的限制部分所述)。通常,禁令會持續 5 分鐘。

為什麼我的 WebSocket 連線被斷開了?

啟用中的 WebSocket 連線每 3 分鐘會收到一個 ping。如您沒有在正確時間段內回應 ping,您的連線就會中斷。

就用戶資料串流,如果未每 60 分鐘至少進行一次傳輸,監聽金鑰將會過期。我們在 API 文件中亦列出本點。

我正在使用第三方服務/封裝函式,但是無法運作了。你們可以幫我們?

抱歉,我們無法支援第三方服務或工具。請洽服務商及/或開發者以尋求進一步協助。

此外,將您的幣安 API 金鑰及/或密鑰輸入任何第三方平台都會導致安全性風險。請自行決定是否使用這些服務。

請注意,我們也盡量避免提供一般程式設計協助。

雖然沒有任何更改,但是我突然收到錯誤訊息。發生什麼事了?

抱歉,我們無法支援因您個人操作所衍生的相關問題。如果您使用第三方封裝函式/工具,請聯繫他們的支援/開發團隊尋求協助。

我需要存取我的密鑰,但是它顯示「***」。我要如何找回密鑰? 

基於安全性理由,密鑰設計為僅能在建立 API 金鑰時可以看見。過了該時間點,金鑰一律會被隱藏。如果您遺失密鑰,或者沒有將它記錄下來,您必須建立新的 API 金鑰,並使用新的金鑰搭配新的密鑰。

我可以增加限制或專屬串流/頻寬嗎?

很遺憾,目前並未提供此功能,但在限制之下應仍可運行。

我的 API 金鑰消失了。

API 金鑰「消失」通常只有兩種可能:

  • 如果您近期未曾啟用金鑰,並僅在 2018 年 3 月 7 日前使用 API,您的 API 金鑰可能會為確保您的帳戶安全性遭到清除。
  • 如果您已停用您的帳戶,這將導致所有有效的 API 金鑰被刪除。

您應該可以毫無問題地創建新的 API 金鑰。

我收到「錯誤 - 1021 (訊息:此請求的時間戳在 recvWindow 之外)」。我要如何解決這個問題?

通常,這個錯誤只有在伺服器時間和系統時間不同步時才會發生。您可能需要同步您的系統時鐘。然而,這個流程會因為作業系統而有所不同。

對 Windows 而言,您可以自行決定使用像「原子鐘」這類工具。Linux 和 Mac 用戶可以嘗試透過命令列與「ntpdate」同步。

若問題持續存在,則可能是延遲相關問題 (網路問題)。請嘗試調整您的 recvWindow。

我可以請求新的 API 功能嗎?

如果您沒有在我們的文件中看見您請求的功能,您應假設我們未提供該功能。如果您想要提出功能建議,您可以開立內附建議內容的客服單,我們會進行審核。

我覺得 API 有問題。我應該如何提報?

如果您認為問題出在系統而非您的使用過程中,請透過我們的開發者論壇提交證據支持您的論述,我們會進行調查。請注意,我們不接受將含糊訊息視為正當投訴。