Back to Website

Articles in this section

Instruments

This endpoint returns specifications for all currently listed Futures contracts and indices.

Authentication is not required.

Endpoint

 Request Type Permissible API Keys
/api/v3/instruments
 GET N/A
Arguments
None
Sample Call
https://www.cryptofacilities.com/derivatives/api/v3/instruments
Sample Return if Successful

{
"result": "success",
"instruments": [
{
"symbol": "pi_xbtusd",
"type": "futures_inverse",
"underlying": "rr_xbtusd",
"tickSize": 0.5,
"contractSize": 1,
"tradeable": true,
"impactMidSize": 1000,
"maxPositionSize": 75000000,
"openingDate": "2018-08-31T00:00:00.000Z",
"marginLevels": [
{
"contracts": 0,
"initialMargin": 0.02,
"maintenanceMargin": 0.01
},
{
"contracts": 500000,
"initialMargin": 0.04,
"maintenanceMargin": 0.02
},
{
"contracts": 1000000,
"initialMargin": 0.06,
"maintenanceMargin": 0.03
},
{
"contracts": 3000000,
"initialMargin": 0.1,
"maintenanceMargin": 0.05
},
{
"contracts": 6000000,
"initialMargin": 0.15,
"maintenanceMargin": 0.075
},
{
"contracts": 12000000,
"initialMargin": 0.25,
"maintenanceMargin": 0.125
},
{
"contracts": 20000000,
"initialMargin": 0.3,
"maintenanceMargin": 0.15
},
{
"contracts": 50000000,
"initialMargin": 0.4,
"maintenanceMargin": 0.2
}
],
"fundingRateCoefficient": 24,
"maxRelativeFundingRate": 0.0025,
"isin": "GB00J62YGL67",
"contractValueTradePrecision": 0,
"postOnly": false,
"retailMarginLevels": [
{
"contracts": 0,
"initialMargin": 0.5,
"maintenanceMargin": 0.25
}
],
"category": "",
"tags": []
},
...
{
"symbol": "fi_ethusd_220930",
"type": "futures_inverse",
"underlying": "rr_ethusd",
"lastTradingTime": "2022-09-30T15:00:00.000Z",
"tickSize": 0.05,
"contractSize": 1,
"tradeable": true,
"impactMidSize": 1000,
"maxPositionSize": 15000000,
"openingDate": "2022-02-25T16:00:06.000Z",
"marginLevels": [
{
"contracts": 0,
"initialMargin": 0.02,
"maintenanceMargin": 0.01
},
{
"contracts": 250000,
"initialMargin": 0.04,
"maintenanceMargin": 0.02
},
{
"contracts": 500000,
"initialMargin": 0.06,
"maintenanceMargin": 0.03
},
{
"contracts": 2000000,
"initialMargin": 0.1,
"maintenanceMargin": 0.05
},
{
"contracts": 4000000,
"initialMargin": 0.15,
"maintenanceMargin": 0.075
},
{
"contracts": 6000000,
"initialMargin": 0.3,
"maintenanceMargin": 0.15
}
],
"isin": "GB00JVMLP377",
"contractValueTradePrecision": 0,
"postOnly": false,
"retailMarginLevels": [
{
"contracts": 0,
"initialMargin": 0.5,
"maintenanceMargin": 0.25
}
],
"category": "",
"tags": []
},

Field

 Type Description
result
 String Always success
serverTime
 ISO8601 datetime The server date and time
instruments
 list of structures A list containing a structures for each available instrument, see below. The list is in no particular order
symbol
 string The symbol of the Futures or index, see Section 3.4.4
type
 string The type of the instrument, either futures_inverse, futures_vanilla, turbo_inverse, spot index or volatility index
tradeable
 boolean True if the instrument can be traded, false otherwise
underlying
 string
  • For Futures: The underlying of the Futures
  • For indices: Not returned because N/A
lastTradingTime
 ISO8601 datetime
  • For Futures: The date and time at which the Futures stops trading
  • For indices: Not returned because N/A
tickSize
 positive float
  • For Futures: The tick size increment of the Futures
  • For indices: Not returned because N/A
contractSize
 positive integer
  • For Futures: For Futures: The contract size of the Futures
  • For indices: Not returned because N/A
impactMidSize positive integer Impact mid size denominated in contracts
maxPositionSize
 positive integer Max position size denominated in contracts
openingDate
 ISO 8601 datetime The date and time at which the Futures started trading
marginLevels
 list of structures
  • For Futures: A list containing the margin schedules
  • For indices: Not returned because N/A
contracts
 positive integer
  • For Futures: The lower limit of the number of contracts that this margin level applies
  • For indices: Not returned because N/A
initialMargin
 positive float
  • For Futures: The initial margin requirement for this level
  • For indices: Not returned because N/A
maintenanceMargin
 positive float
  • For Futures: The maintenance margin requirement for this level
  • For indices: Not returned because N/A

 

Sample Return if Unsuccessful
{  
   "result":"error",
   "serverTime":"2016-02-25T09:45:53.818Z",
   "error":"apiLimitExceeded",
}

Field

 Type Description
result
 String Always error
serverTime
 ISO8601 datetime The server date and time
error
 string

The reason the API call failed, either of:

  • apiLimitExceeded: the API limit for the calling IP address has been exceeded 
  • unavailable: the requested resource is unavailable