Symbol

danger

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.

Get Open Contract List

Submit request to get the info of all open contracts.

HTTP Request

GET https://futures-api.poloniex.com/api/v1/contracts/active

Example

GET https://futures-api.poloniex.com/api/v1/contracts/active

PARAMETERS

N/A

Example:

  {
    "code": "200000",
    "data": {
      "baseCurrency": "XBT",  //Base currency
      "fairMethod": "FundingRate", //Fair price marking method
      "fundingBaseSymbol": ".XBTINT8H",  //Ticker symbol of the based currency
      "fundingQuoteSymbol": ".USDINT8H", //Ticker symbol of the quote currency
      "fundingRateSymbol": ".BTCUSDTPERPFPI8H",  //Funding rate symbol
      "indexSymbol": ".PXBT",    //Index symbol
      "initialMargin": 0.01, //Initial margin requirement
      "isDeleverage": true,   //Enabled ADL or not
      "isInverse": true,  //Reverse contract or not
      "isQuanto": false,   //Whether quanto or not
      "lotSize": 1,   //Minimum lot size
      "maintainMargin": 0.005,    //Maintenance margin requirement
      "makerFeeRate": -0.00025,  //Maker fees
      "makerFixFee": -0.0000000200,   //Fixed maker fees
      "markMethod": "FairPrice", //Marking method
      "maxOrderQty": 1000000,   //Maximum order quantity
      "maxPrice": 1000000.0000000000,  //Maximum order price   
      "maxRiskLimit": 200,  //Maximum risk limit (unit: XBT)
      "minRiskLimit": 200,  //Minimum risk limit (unit: XBT)
      "multiplier": -1,    //Contract multiplier
      "quoteCurrency": "USD",  //Quote currency
      "riskStep": 100,  //Risk limit increment value (unit: XBT)
      "rootSymbol": "XBT", //Contract group
      "status": "Open", //Contract status
      "symbol": "BTCUSDTPERP", //Ticker symbol of the contract
      "takerFeeRate": 0.0005,  //Taker fees
      "takerFixFee": 0.0000000600,   //Fixed taker fees
      "tickSize": 1,  //Minimum price changes
      "type": "FFWCSX",  //Type of the contract
      "maxLeverage": 100,   //maximum leverage 
      "volumeOf24h": 14848115, //volume of 24 hours
      "turnoverOf24h": 1590.20278373, //turnover of 24 hours
      "openInterest": "10621721"  //open interest
    }
  }

Get Order Info. of the Contract

Submit request to get info of the specified contract.

HTTP Request

GET https://futures-api.poloniex.com/api/v1/contracts/{symbol}

Example

GET https://futures-api.poloniex.com/api/v1/contracts/BTCUSDTPERP

PARAMETERS

Param	Type	Description
symbol	String	Path Parameter. Symbol of the contract

Example:

  {
    "code": "200000",
    "data": {
      "baseCurrency": "XBT",  //Base currency
      "fairMethod": "FundingRate", //Fair price marking method
      "fundingBaseSymbol": ".XBTINT8H",  //Ticker symbol of the based currency
      "fundingQuoteSymbol": ".USDINT8H", //Ticker symbol of the quote currency
      "fundingRateSymbol": ".BTCUSDTPERPFPI8H",  //Funding rate symbol
      "indexSymbol": ".PXBT",    //Index symbol
      "initialMargin": 0.01, //Initial margin requirement
      "isDeleverage": true,   //Enabled ADL or not
      "isInverse": true,  //Reverse contract or not
      "isQuanto": false,   //Whether quanto or not
      "lotSize": 1,   //Minimum lot size
      "maintainMargin": 0.005,    //Maintenance margin requirement
      "makerFeeRate": -0.00025,  //Maker fees
      "makerFixFee": -0.0000000200,   //Fixed maker fees
      "markMethod": "FairPrice", //Marking method
      "maxOrderQty": 1000000,   //Maximum order quantity
      "minOrderQty": 1,   //Minimum order quantity
      "maxPrice": 1000000.0000000000,  //Maximum order price   
      "maxRiskLimit": 200,  //Maximum risk limit (unit: XBT)
      "minRiskLimit": 200,  //Minimum risk limit (unit: XBT)
      "multiplier": -1,    //Contract multiplier
      "quoteCurrency": "USD",  //Quote currency
      "riskStep": 100,  //Risk limit increment value (unit: XBT)
      "rootSymbol": "XBT", //Contract group
      "status": "Open", //Contract status
      "symbol": "BTCUSDTPERP", //Ticker symbol of the contract
      "takerFeeRate": 0.0005,  //Taker fees
      "takerFixFee": 0.0000000600,   //Fixed taker fees
      "tickSize": 1,  //Minimum price changes
      "type": "FFWCSX",    //Type of the contract
      "maxLeverage": 100   //maximum leverage 
    }
  }