Skip to main content

General API Information

  • The base endpoint is https://testnet.binance.vision/api
  • Responses are in JSON by default. To receive responses in SBE, refer to the SBE FAQ page.
  • Data is returned in ascending order. Oldest first, newest last.
  • All time and timestamp related fields in the JSON responses are in milliseconds by default. To receive the information in microseconds, please add the header X-MBX-TIME-UNIT:MICROSECOND or X-MBX-TIME-UNIT:microsecond.
  • Timestamp parameters (e.g. startTime, endTime, timestamp) can be passed in milliseconds or microseconds.
  • If there are enums or terms you want clarification on, please see the SPOT Glossary for more information.
  • APIs have a timeout of 10 seconds when processing a request. If a response from the Matching Engine takes longer than this, the API responds with "Timeout waiting for response from backend server. Send status unknown; execution status unknown." (-1007 TIMEOUT)
    • This does not always mean that the request failed in the Matching Engine.
    • If the status of the request has not appeared in User Data Stream, please perform an API query for its status.