跳到主要内容

Futures API Introduction

危险

Poloniex futures v1/v2 API will be officially offline on November 30, 2024. You can access the V3 API to provide you with a better trading experience.

Poloniex Futures provides both REST APIs and Websocket Feeds for interacting with our futures exchange. Both allow read access to public market data and private read access to your account. Private write access to your account is available via the private REST API. This documentation provides a detailed explanation of transaction functions and how to get market data from Poloniex Futures.

Our documentation is divided into two parts: 1) REST API and 2) Websocket Feed.

  • The REST API part contains three sections: User (private) , Trade (private) and Market Data (public).
  • The Websocket Feed part contains two sections: Public Channels and Private Channels.

To get started with your Poloniex Futures API please create an API key within your account Settings, https://poloniex.com/profile/settings/futures-api-key.

Minimize Latency​

If you will be performing high-frequency trading, you may wish to locate your bots as close to our servers as possible. As Poloniex Futures uses Cloudflare for all requests, you can minimize network latency by positioning your client near the Cloudflare gateway in Tokyo, Japan. You can identify which Cloudflare gateway your client is accessing by running this command on the same machine as your bot:

curl -s https://www.cloudflare.com/cdn-cgi/trace

Cloudflare's Tokyo data center will return a "colo" field of "NRT". If you get a different "colo" value, you can look up the location at https://www.cloudflarestatus.com.

Request Rate Limit​

When a rate limit is exceeded, a status of 429 Too Many Requests will be returned.

Warning

If the rate limit is exceeded multiple times, the system will restrict your use of your IP and account for 1 minute.

REST API​

The limit strategy of private endpoints will restrict account by userid. The limit strategy of public endpoints will restrict IP.

Warning

Note that when an API has a specific rate limit, please refer to the specific limit.

Will response following string for "header" via api:

  • ratelimit-limit: the upper limit of requests per time, unit: times
  • ratelimit-interval: reset interval (reset the number of request), unit: second
  • ratelimit-remaining: the left available request number for this round, unit: times

Apply for Higher Request Rate Limit

If you are a professional trader or market maker and need a higher limit, please send your Poloniex Futures account, reason and approximate trading volume to api-support@poloniex.com.

WEBSOCKET​

  • Number of Connections: Number of connections per user ID: ≤ 10
  • Connection Times: Connection Limit: 30 per minute
  • Number of Uplink Messages: Message limit sent to server: 100 per 10 seconds
  • Topic Subscription Limit: Subscription limit for each connection: 100 topics