NAV
API Documentation
python javascript csharp
English 中文

Overview

Welcome to the FTX API documentation. We offer complete REST, Websocket, and FIX APIs to suit your algorithmic trading needs. You can find sample code for each connectivity option at https://github.com/ftexchange/ftx.

REST API

HTTP-based API with full trading and asset management functionality, with public orderbook and trades data as well as private account data and order management.

REST endpoint URL: https://ftx.com/api

Requests and responses use JSON.

We also have sample code for Python, C# and C++.

Authentication

import time
import hmac
from requests import Request

ts = int(time.time() * 1000)
request = Request('GET', '<api_endpoint>')
prepared = request.prepare()
signature_payload = f'{ts}{prepared.method}{prepared.path_url}'.encode()
signature = hmac.new('YOUR_API_SECRET'.encode(), signature_payload, 'sha256').hexdigest()

request.headers['FTX-KEY'] = 'YOUR_API_KEY'
request.headers['FTX-SIGN'] = signature
request.headers['FTX-TS'] = str(ts)

# Only include line if you want to access a subaccount. Remember to URI-encode the subaccount name if it contains special characters!
# request.headers['FTX-SUBACCOUNT'] = 'my_subaccount_nickname'

var method = HttpMethod.Get
var endpoint = $"/api/account";
var request = new HttpRequestMessage(method, endpoint);
var _nonce = (DateTime.UtcNow - start).TotalMilliseconds;

var hashMaker = new HMACSHA256(Encoding.UTF8.GetBytes(""YOUR_API_SECRET""));
var signaturePayload = $"{_nonce}{method.ToString().ToUpper()}{endpoint}";
var hash = hashMaker.ComputeHash(Encoding.UTF8.GetBytes(signaturePayload));
var hashString = BitConverter.ToString(hash).Replace("-", string.Empty);
var signature = hashString.ToLower();

request.Headers.Add("FTX-KEY", "YOUR_API_KEY");
request.Headers.Add("FTX-SIGN", signature);
request.Headers.Add("FTX-TS", _nonce.ToString());

For authenticated requests, the following headers should be sent with the request:

You will find a detailed example on how to authenticate here

Rate limits

Please do not send more than 30 requests per second: doing so will result in HTTP 429 errors. We strongly recommend using the websocket API for faster market and account data.

Pagination

FTX supports pagination on most REST API endpoints. Pagination allows you to specify the time range of data to be returned, which also enables you to retrieve more results than are returned by default. You can find sample Python code which demonstrates pagination using the start_time and end_time parameters here

Subaccounts

To specify a subaccount, include its URI-encoded nickname in the header FTX-SUBACCOUNT with the request.

Get all subaccounts

Request

GET /subaccounts

Response

{
  "success": true,
  "result": [
    {
      "nickname": "sub1",
      "deletable": true,
      "editable": true,
      "competition": true
    }
  ]
}

Requires authentication.

Response format

Name Type Value Description
nickname string sub1 subaccount name
deletable boolean true whether the subaccount can be deleted
editable boolean true whether the nickname of the subaccount can be changed
competition boolean true whether the subaccount was created for a competition

Create subaccount

Request

POST /subaccounts

{
  "nickname": "sub2",
}

Response

{
  "success": true,
  "result": {
    "nickname": "sub2",
    "deletable": true,
    "editable": true,
  }
}

Requires authentication.

Payload format

Name Type Value Description
nickname string sub2

Response format

Name Type Value Description
nickname string sub2 subaccount name
deletable boolean true whether the subaccount can be deleted
editable boolean true whether the nickname of the subaccount can be changed

Change subaccount name

Request

POST /subaccounts/update_name

{
  "nickname": "sub2",
  "newNickname": "newSub2"
}

Response

{
  "success": true,
  "result": null
}

Requires authentication.

Payload format

Name Type Value Description
nickname string sub2 current nickname of subaccount
newNickname string newSub2 new nickname of subaccount

Delete subaccount

Request

DELETE /subaccounts

{
  "nickname": "sub2",
}

Response

{
  "success": true,
  "result": null
}

Requires authentication.

Payload format

Name Type Value Description
nickname string sub2

Get subaccount balances

Request

GET /subaccounts/{nickname}/balances

Response


{
  "success": true,
  "result": [
    {
      "coin": "USDT",
      "free": 4321.2,
      "total": 4340.2
    }
  ]
}

Requires authentication.

Response format

Name Type Value Description
coin string USDT coin id
free number 4321.2 free amount
total number 4340.2 total amount

Transfer between subaccounts

Request

POST /subaccounts/transfer

{
  "coin": "XRP",
  "size": 10000,
  "source": null,
  "destination": "sub1",
}

Response

{
  "success": true,
  "result": {
    "id": 316450,
    "coin": "XRP",
    "size": 10000,
    "time": "2019-03-05T09:56:55.728933+00:00",
    "notes": "",
    "status": "complete",
  }
}

Requires authentication.

Payload format

Name Type Value Description
coin string XRP
size number 31431.0
source string main name of the source subaccount. Use null or 'main' for the main account
destination string sub1 name of the destination subaccount. Use null or 'main' for the main account

Response format

Name Type Value Description
id number 316450
coin string XRP
size number 10000
time string 2019-03-05T09:56:55.728933+00:00
notes string
status string complete always 'complete'

Markets

This section covers all types of markets on FTX: spot, perpetual futures, expiring futures, and MOVE contracts. Examples for each type are BTC/USD, BTC-PERP, BTC-0626, and BTC-MOVE-1005. For futures that expired in 2019, prepend a 2019 to the date, like so: BTC-20190628 or BTC-MOVE-20190923.

Get markets

Request

GET /markets

Response


{
  "success": true,
  "result": [
    {
      "name": "BTC-0628",
      "baseCurrency": null,
      "quoteCurrency": null,
      "type": "future",
      "underlying": "BTC",
      "enabled": true,
      "ask": 3949.25,
      "bid": 3949,
      "last": 10579.52,
      "postOnly": false,
      "priceIncrement": 0.25,
      "sizeIncrement": 0.001,
      "restricted": false
    }
  ]
}

Response format

Name Type Value Description
type string future "future" or "spot"
name string BTC-0628 e.g. "BTC/USD" for spot, "BTC-PERP" for futures
underlying string BTC future markets only
baseCurrency string BTC spot markets only
quoteCurrency string USD spot markets only
enabled boolean true
ask number 3949.25 best ask
bid number 3949.00 best bid
last number 3949.00 last traded price
postOnly boolean false if the market is in post-only mode (all orders get modified to be post-only, in addition to other settings they may hve)
priceIncrement number 0.25
sizeIncrement number 0.001
restricted boolean false if the market has nonstandard restrictions on which jurisdictions can trade it

Get single market

Request

GET /markets/{market_name}

Response

See /markets

Get orderbook

Request

GET /markets/{market_name}/orderbook?depth={depth}

Response

{
  "success": true,
  "result": {
    "asks": [
      [
        4114.25,
        6.263
      ]
    ],
    "bids": [
      [
        4112.25,
        49.29
      ]
    ]
  }
}

Parameters

Name Type Value Description
market_name string BTC-0628 Required. Name of the market.
depth number 35 max 100, default 20

Response format

Name Type Value Description
asks array [4114.25, 6.263] Array with price and size
bids array [4112, 49.29] Array with price and size

Get trades

Request

GET /markets/{market_name}/trades?limit={limit}&start_time={start_time}&end_time={end_time}

Response

{
  "success": true,
  "result": [
    {
      "id": 3855995,
      "liquidation": false,
      "price": 3857.75,
      "side": "buy",
      "size": 0.111,
      "time": "2019-03-20T18:16:23.397991+00:00"
    }
  ]
}

Parameters

Name Type Value Description
market_name string BTC-0628 name of the market
limit number 35 optional, max 100, default 20
start_time number 1559881511 optional
end_time number 1559881711 optional

Response format

Name Type Value Description
id number 3855995 trade id
liquidation boolean false if this trade involved a liquidation order
price number 3857.75
side string buy
size number 0.111
time string 2019-03-20T18:16:23.397991+00:00

Get historical prices

Historical prices of expired futures can be retrieved with this end point but make sure to specify start time and end time.

Request

GET /markets/{market_name}/candles?resolution={resolution}&limit={limit}&start_time={start_time}&end_time={end_time}

Response

{
  "success": true,
  "result": [
    {
      "close": 11055.25,
      "high": 11089.0,
      "low": 11043.5,
      "open": 11059.25,
      "startTime": "2019-06-24T17:15:00+00:00",
      "volume": 464193.95725
    }
  ]
}

Parameters

Name Type Value Description
market_name string BTC-0628 name of the market
resolution number 300 window length in seconds. options: 15, 60, 300, 900, 3600, 14400, 86400
limit number 35 optional, max 5000
start_time number 1559881511 optional
end_time number 1559881711 optional

Response format

Name Type Value Description
startTime string 2019-06-24T17:15:00+00:00 start time of the window
open number 11059.25 mark price at startTime
close number 11055.25 mark price at the end of the window: startTime + resolution
high number 11089.0 highest mark price over the window
low number 11059.25 lowest mark price over the window
volume number 464193.95725 volume traded in the window

Futures

This section covers all types of futures on FTX: perpetual, expiring, and MOVE. Examples for each type are BTC-PERP, BTC-0626, and BTC-MOVE-1005. For futures that expired in 2019, prepend a 2019 to the date, like so: BTC-20190628.

List all futures

Request

GET /futures

Response

{
  "success": true,
  "result": [
    {
      "ask": 4196,
      "bid": 4114.25,
      "change1h": 0,
      "change24h": 0,
      "changeBod": 0,
      "volumeUsd24h": 100000000,
      "volume": 24390.24,
      "description": "Bitcoin March 2019 Futures",
      "enabled": true,
      "expired": false,
      "expiry": "2019-03-29T03:00:00+00:00",
      "index": 3919.58841011,
      "imfFactor": 0.002,
      "last": 4196,
      "lowerBound": 3663.75,
      "mark": 3854.75,
      "name": "BTC-0329",
      "perpetual": false,
      "positionLimitWeight": 1.0,
      "postOnly": false,
      "priceIncrement": 0.25,
      "sizeIncrement": 0.001,
      "underlying": "BTC",
      "upperBound": 4112.2,
      "type": "future"
    }
  ]
}

Response format

Name Type Value Description
ask number 4196.0 best ask on the orderbook
bid number 4114.25 best bid on the orderbook
change1h number 0.0 price change in the last hour
change24h number 0.0 price change in the last 24 hours
changeBod number 0.0 price change since midnight UTC (beginning of day)
volumeUsd24h number 100000000 USD volume in the last 24 hours
volume number 24390.24 quantity traded in the last 24 hours
description string Bitcoin March 2019 Futures
enabled boolean true
expired boolean false
expiry string 2019-03-29T03:00:00+00:00
index number 3919.58841011 average of the Market Prices for the constituent markets in the index
imfFactor number 0.002
last number 4196.0 last price the future traded at
lowerBound number 3663.75 the lowest price the future can trade at
mark number 3854.75 mark price of the future
name string BTC-0329
perpetual boolean false whether or not this is a perpetual contract
positionLimitWeight number 1.0
postOnly boolean false
priceIncrement number 0.25
sizeIncrement number 0.001
underlying string BTC
upperBound number 4112.2 the highest price the future can trade at
type string future One of future, perpetual, or move

Get future

Request

GET /futures/{future_name}

Response

{
  "success": true,
  "result": {
    "ask": 4196,
    "bid": 4114.25,
    "change1h": 0,
    "change24h": 0,
    "description": "Bitcoin March 2019 Futures",
    "enabled": true,
    "expired": false,
    "expiry": "2019-03-29T03:00:00+00:00",
    "index": 3919.58841011,
    "last": 4196,
    "lowerBound": 3663.75,
    "mark": 3854.75,
    "name": "BTC-0329",
    "perpetual": false,
    "postOnly": false,
    "priceIncrement": 0.25,
    "sizeIncrement": 0.001,
    "underlying": "BTC",
    "upperBound": 4112.2,
    "type": "future"
  }
}

Response format

Name Type Value Description
ask number 4196.0 best ask on the orderbook
bid number 4114.25 best bid on the orderbook
change1h number 0.0 price change in the last hour
change24h number 0.0 price change in the last 24 hours
description string Bitcoin March 2019 Futures
enabled boolean true
expired boolean false
expiry string 2019-03-29T03:00:00+00:00
index number 3919.58841011 average of the Market Prices for the constituent markets in the index
last number 4196.0 last price the future traded at
lowerBound number 3663.75 the lowest price the future can trade at
mark number 3854.75 mark price of the future
name string BTC-0329
perpetual boolean false whether or not this is a perpetual contract
postOnly boolean false
priceIncrement number 0.25
sizeIncrement number 0.001
underlying string BTC
upperBound number 4112.2 the highest price the future can trade at
type string future One of future, perpetual, or move

Get future stats

Request

GET /futures/{future_name}/stats

Response

{
  "success": true,
  "result": {
    "volume": 1000.23,
    "nextFundingRate": 0.00025,
    "nextFundingTime": "2019-03-29T03:00:00+00:00",
    "expirationPrice": 3992.1,
    "predictedExpirationPrice": 3993.6,
    "strikePrice": 8182.35,
    "openInterest": 21124.583
  }
}

Response format

Name Type Value Description
volume number 1000.23 quantity traded in the last 24 hours
nextFundingRate number 0.00025 upcoming funding rate (only applicable for perpetual contracts)
nextFundingTime string 2019-03-29T03:00:00+00:00 upcoming funding time (only applicable for perpetual contracts)
expirationPrice number 3992.1 price to which the future expired (only applicable if the future has expired)
predictedExpirationPrice number 3993.0 only applicable if the future has not expired
openInterest number 21124.583 number of open contracts in this future
strikePrice number 8182.35009484 price of the underlying at the beginning of the expiration day (only applicable for MOVE contracts)

Get funding rates

Request

GET /funding_rates

Parameters

Name Type Value Description
start_time number 1559881511 optional
end_time number 1559881711 optional
future string BTC-PERP optional

Response


{
  "success": true,
  "result": [
    {
      "future": "BTC-PERP",
      "rate": 0.0025,
      "time": "2019-06-02T08:00:00+00:00"
    }
  ]
}

Response format

Name Type Value Description
future string BTC-PERP
rate number 0.0025
time string 2019-06-02T08:00:00+00:00

Get index weights

Request

GET /indexes/{index_name}/weights

Note that this only applies to index futures, e.g. ALT/MID/SHIT/EXCH/DRAGON.

Response

{
  "success": true,
  "result": {
    "BCH": 0.3492,
    "BNB": 2.8632,
    "BSV": 0.3471,
    "EOS": 18.1707,
    "ETH": 0.5724,
    "LTC": 1.2973,
    "XRP": 573.6345,
  }
}

Get expired futures

Returns the list of all expired futures.

Request

GET /expired_futures

Response

{
  "success": true,
  "result": [
    {
      "ask": null,
      "bid": null,
      "description": "Bitcoin March 2020 Futures",
      "enabled": false,
      "expired": true,
      "expiry": "2020-03-27T03:00:00+00:00",
      "expiryDescription": "March 2020",
      "group": "quarterly",
      "imfFactor": 0.002,
      "index": 6807.943073426,
      "last": 6804.75,
      "lowerBound": 6467.75,
      "marginPrice": 6801.1226609324885,
      "mark": 6801.1226609324885,
      "moveStart": null,
      "name": "BTC-0327",
      "perpetual": false,
      "positionLimitWeight": 2.0,
      "postOnly": false,
      "priceIncrement": 0.5,
      "sizeIncrement": 0.0001,
      "type": "future",
      "underlying": "BTC",
      "underlyingDescription": "Bitcoin",
      "upperBound": 7152.75
    }
  ]
}

Get historical index

Request

GET /indexes/{market_name}/candles?resolution={resolution}&limit={limit}&start_time={start_time}&end_time={end_time}

Response

{
  "success": true,
  "result": [
    {
      "close": 11055.25,
      "high": 11089.0,
      "low": 11043.5,
      "open": 11059.25,
      "startTime": "2019-06-24T17:15:00+00:00",
      "volume": null
    }
  ]
}

Parameters

Name Type Value Description
index_name string BTC name of the market
resolution number 300 window length in seconds. options: 15, 60, 300, 900, 3600, 14400, 86400
limit number 35 optional
start_time number 1559881511 optional
end_time number 1559881711 optional

Response format

Name Type Value Description
startTime string 2019-06-24T17:15:00+00:00 start time of the window
open number 11059.25 mark price at startTime
close number 11055.25 mark price at the end of the window: startTime + resolution
high number 11089.0 highest mark price over the window
low number 11059.25 lowest mark price over the window
volume number null volume traded in the window

Account

Get account information

Request

GET /account

Response

{
  "success": true,
  "result": {
    "backstopProvider": true,
    "collateral": 3568181.02691129,
    "freeCollateral": 1786071.456884368,
    "initialMarginRequirement": 0.12222384240257728,
    "leverage": 10,
    "liquidating": false,
    "maintenanceMarginRequirement": 0.07177992558058484,
    "makerFee": 0.0002,
    "marginFraction": 0.5588433331419503,
    "openMarginFraction": 0.2447194090423075,
    "takerFee": 0.0005,
    "totalAccountValue": 3568180.98341129,
    "totalPositionSize": 6384939.6992,
    "username": "[email protected]",
    "positions": [
      {
        "cost": -31.7906,
        "entryPrice": 138.22,
        "future": "ETH-PERP",
        "initialMarginRequirement": 0.1,
        "longOrderSize": 1744.55,
        "maintenanceMarginRequirement": 0.04,
        "netSize": -0.23,
        "openSize": 1744.32,
        "realizedPnl": 3.39441714,
        "shortOrderSize": 1732.09,
        "side": "sell",
        "size": 0.23,
        "unrealizedPnl": 0
      }
    ]
  }
}

Requires authentication.

Response format

Name Type Value Description
backstopProvider boolean true whether or not the account is a registered backstop liquidity provider
collateral number 3568181.02691129 amount of collateral
freeCollateral number 1786071.456884368 amount of free collateral
initialMarginRequirement number 0.12222384240257728 average of initialMarginRequirement for individual futures, weighed by position notional. Cannot open new positions if openMarginFraction falls below this value.
liquidating boolean false True if the account is currently being liquidated
maintenanceMarginRequirement number 0.07177992558058484 Average of maintenanceMarginRequirement for individual futures, weighed by position notional. Account enters liquidation mode if margin fraction falls below this value.
makerFee number 0.0002 -
marginFraction number 0.5588433331419503 - ratio between total account value and total account position notional.
openMarginFraction number 0.2447194090423075 Ratio between total realized account value and total open position notional
takerFee number 0.0005
totalAccountValue number 3568180.98341129 total value of the account, using mark price for positions
totalPositionSize number 6384939.6992 total size of positions held by the account, using mark price
username string [email protected]
leverage number 10.0 Max account leverage
positions array See Get positions for details

Get positions

Request

GET /positions

Response

{
  "success": true,
  "result": [
    {
      "cost": -31.7906,
      "entryPrice": 138.22,
      "estimatedLiquidationPrice": 152.1,
      "future": "ETH-PERP",
      "initialMarginRequirement": 0.1,
      "longOrderSize": 1744.55,
      "maintenanceMarginRequirement": 0.04,
      "netSize": -0.23,
      "openSize": 1744.32,
      "realizedPnl": 3.39441714,
      "shortOrderSize": 1732.09,
      "side": "sell",
      "size": 0.23,
      "unrealizedPnl": 0
    }
  ]
}

Requires authentication.

Parameters

Name Type Value Description
showAvgPrice boolean false optional

Response format

Name Type Value Description
cost number -31.7906 Amount that was paid to enter this position, equal to size * entry_price. Positive if long, negative if short.
entryPrice number 138.22 Average cost of this position after pnl was last realized: whenever unrealized pnl gets realized, this field gets set to mark price, unrealizedPnL is set to 0, and realizedPnl changes by the previous value for unrealizedPnl.
estimatedLiquidationPrice number 152.1
future string ETH-PERP future name
initialMarginRequirement number 0.1 Minimum margin fraction for opening new positions
longOrderSize number 1744.55 Cumulative size of all open bids
maintenanceMarginRequirement number 0.04 Minimum margin fraction to avoid liquidations
netSize number -0.23 Size of position. Positive if long, negative if short.
openSize number 1744.32 Maximum possible absolute position size if some subset of open orders are filled
realizedPnl number 3.39441714
shortOrderSize number 1732.09 Cumulative size of all open offers
side string sell sell if short, buy if long
size number 0.23 Absolute value of netSize
unrealizedPnl number 0.0

Change account leverage

Request

POST /account/leverage

{
  "leverage": 10,
}

Requires authentication.

Payload format

Name Type Value Description
leverage number 10 desired acccount-wide leverage setting

Wallet

Get coins

Request

GET /wallet/coins

Response


{
  "success": true,
  "result": [
    {
      "canDeposit": true,
      "canWithdraw": true,
      "hasTag": false,
      "id": "USDTBEAR",
      "name": "3X Short Tether Token"
    }
  ]
}

Requires authentication.

Response format

Name Type Value Description
canDeposit boolean true
canWithdraw boolean true
hasTag boolean false true if addresses for this coin have a tag
id string USDTBEAR
name string 3X Short Tether Token

Get balances

Request

GET /wallet/balances

Response


{
  "success": true,
  "result": [
    {
      "coin": "USDTBEAR",
      "free": 2320.2,
      "total": 2340.2
    }
  ]
}

Requires authentication.

Response format

Name Type Value Description
coin string USDTBEAR coin id
free number 2320.2 free amount
total number 2340.2 total amount

Get balances of all accounts

Request

GET /wallet/all_balances

Response


{
  "success": true,
  "result": {
    "main": [
      {
        "coin": "USDTBEAR",
        "free": 2320.2,
        "total": 2340.2
      },
      {
        "coin": "BTC",
        "free": 2.0,
        "total": 3.2
      }
    ],
    "Battle Royale": [
      {
        "coin": "USD",
        "free": 2000.0,
        "total": 2200.0
      }
    ]
  }
}

Requires authentication.

The response will contain an object whose keys are the subaccount names. The main account will appear under the key main.

Response format

Name Type Value Description
coin string USDTBEAR coin id
free number 2320.2 free amount
total number 2340.2 total amount

Get deposit address

Request

GET /wallet/deposit_address/{coin}

Response

{
  "success": true,
  "result": {
    "address": "0x83a127952d266A6eA306c40Ac62A4a70668FE3BE",
    "tag": null
  }
}

Requires authentication.

Response format

Name Type Value Description
address string 0x83a127952d266A6eA306c40Ac62A4a70668FE3BE
tag string null optional

Get deposit history

Request

GET /wallet/deposits

Response

{
  "success": true,
  "result": [
    {
      "coin": "TUSD",
      "confirmations": 64,
      "confirmedTime": "2019-03-05T09:56:55.728933+00:00",
      "fee": 0,
      "id": 1,
      "sentTime": "2019-03-05T09:56:55.735929+00:00",
      "size": 99.0,
      "status": "confirmed",
      "time": "2019-03-05T09:56:55.728933+00:00",
      "txid": "0x8078356ae4b06a036d64747546c274af19581f1c78c510b60505798a7ffcaf1"
    }
  ]
}

Requires authentication.

Request parameters

Name Type Value Description
limit number 20 optional; number of items to return
start_time number 1564146934 optional; minimum time of items to return, in Unix time (seconds since 1970-01-01)
end_time number 1564233334 optional; maximum time of items to return, in Unix time (seconds since 1970-01-01)

Response format

Name Type Value Description
coin string TUSD coin id
confirmations number 64 number of blockchain confirmations
confirmedTime string 2019-03-05T09:56:55.728933+00:00
fee number 0.0 fee, not included in size
id number 1 deposit id
sentTime string 2019-03-05T09:56:55.735929+00:00
size string 99.0
status string confirmed one of "confirmed", "unconfirmed", or "cancelled"
time string 2019-03-05T09:56:55.728933+00:00
txid string 0x8078356ae4b06a036d64747546c274af19581f1c78c510b60505798a7ffcaf1 optional
notes string Transfer from main account to my_subaccount optional

Get withdrawal history

Request

GET /wallet/withdrawals

Response

{
  "success": true,
  "result": [
    {
      "coin": "TUSD",
      "address": "0x83a127952d266A6eA306c40Ac62A4a70668FE3BE",
      "tag": null,
      "fee": 0,
      "id": 1,
      "size": 99.0,
      "status": "complete",
      "time": "2019-03-05T09:56:55.728933+00:00",
      "txid": "0x8078356ae4b06a036d64747546c274af19581f1c78c510b60505798a7ffcaf1"
    }
  ]
}

Requires authentication.

Request parameters

Name Type Value Description
limit number 20 optional; number of items to return
start_time number 1564146934 optional; minimum time of items to return, in Unix time (seconds since 1970-01-01)
end_time number 1564233334 optional; maximum time of items to return, in Unix time (seconds since 1970-01-01)

Response format

Name Type Value Description
coin string TUSD coin id
address string 0x83a127952d266A6eA306c40Ac62A4a70668FE3BE deposit address the withdrawal was sent to
tag string null
fee number 0.0 fee, not included in size
id number 1 withdrawal id
size string 99.0
status string complete one of "requested", "processing", "complete", or "cancelled"
time string 2019-03-05T09:56:55.728933+00:00
txid string 0x8078356ae4b06a036d64747546c274af19581f1c78c510b60505798a7ffcaf1 optional
notes string Transfer from main account to my_subaccount optional

Request withdrawal

Request

POST /wallet/withdrawals

{
  "coin": "USDTBEAR",
  "size": 20.2,
  "address": "0x83a127952d266A6eA306c40Ac62A4a70668FE3BE",
  "tag": null,
  "password": "my_withdrawal_password",
  "code": "152823
}

Response

{
  "success": true,
  "result": {
    "coin": "USDTBEAR",
    "address": "0x83a127952d266A6eA306c40Ac62A4a70668FE3BE",
    "tag": null,
    "fee": 0,
    "id": 1,
    "size": 20.2,
    "status": "requested",
    "time": "2019-03-05T09:56:55.728933+00:00",
    "txid": null
  }
}

Requires authentication.

Payload format

Name Type Value Description
coin string USDTBEAR coin to withdraw
size number 20.2 amount to withdraw
address string 0x83a127952d266A6eA306c40Ac62A4a70668FE3BE address to send to
tag string null optional
password string null optional; withdrawal password if it is required for your account
code string null optiona; 2fa code if it is required for your account

Response format

Name Type Value Description
coin string USDTBEAR coin id
address string 0x83a127952d266A6eA306c40Ac62A4a70668FE3BE deposit address the withdrawal was sent to
tag string null
fee number 0.0 fee, not included in size
id number 1 withdrawal id
size string 20.2
status string requested one of "requested", "processing", "complete", or "cancelled"
time string 2019-03-05T09:56:55.728933+00:00
txid string null

Get airdrops

This endpoint provides you with updates to your AMPL balances based on AMPL rebases.

Request

GET /wallet/airdrops

Response

{
  "success": true,
  "result": [
    {
      "coin": "AMPL",
      "id": 1,
      "size": 99.0,
      "time": "2019-03-05T09:56:55.728933+00:00",
      "status": "complete"
    }
  ]
}

Requires authentication.

Request parameters

Name Type Value Description
limit number 20 optional; number of items to return
start_time number 1564146934 optional; minimum time of items to return, in Unix time (seconds since 1970-01-01)
end_time number 1564233334 optional; maximum time of items to return, in Unix time (seconds since 1970-01-01)

Response format

Name Type Value Description
coin string AMPL coin id
id number 1 aidrop id
size string 99.0
status string confirmed one of "confirmed" or "pending"
time string 2019-03-05T09:56:55.728933+00:00

Orders

Get open orders

Request

GET /orders?market={market}

Response

{
  "success": true,
  "result": [
    {
      "createdAt": "2019-03-05T09:56:55.728933+00:00",
      "filledSize": 10,
      "future": "XRP-PERP",
      "id": 9596912,
      "market": "XRP-PERP",
      "price": 0.306525,
      "avgFillPrice": 0.306526,
      "remainingSize": 31421,
      "side": "sell",
      "size": 31431,
      "status": "open",
      "type": "limit",
      "reduceOnly": false,
      "ioc": false,
      "postOnly": false,
      "clientId": null
    }
  ]
}

Requires authentication.

Request parameters

Name Type Value Description
market string BTC-0329 optional; market to limit orders

Response format

Name Type Value Description
id number 9596912
market string XRP-PERP
type string limit
side string sell
price number 0.306525
size number 31431.0
filledSize number 10.0
remainingSize number 31421.0
avgFillPrice number 0.306526
status string new (accepted but not processed yet), open, or closed (filled or cancelled)
createdAt string 2019-03-05T09:56:55.728933+00:00
reduceOnly boolean false
ioc boolean false
postOnly boolean false
clientId string optional; client order id

Get order history

Request

GET /orders/history?market={market}

Response

{
  "success": true,
  "result": [
    {
      "avgFillPrice": 10135.25,
      "clientId": null,
      "createdAt": "2019-06-27T15:24:03.101197+00:00",
      "filledSize": 0.001,
      "future": "BTC-PERP",
      "id": 257132591,
      "ioc": false,
      "market": "BTC-PERP",
      "postOnly": false,
      "price": 10135.25,
      "reduceOnly": false,
      "remainingSize": 0.0,
      "side": "buy",
      "size": 0.001,
      "status": "closed",
      "type": "limit"
    },
  ],
  "hasMoreData": false,
}

Requires authentication.

Request parameters

Name Type Value Description
market string BTC-0329 optional; market to limit orders
start_time number 1559881511 optional; only fetch orders created after this time
end_time number 1559901511 optional; only fetch orders created before this time
limit number 100 optional; default 100, maximum 100

Response format

Name Type Value Description
id number 257132591
market string BTC-PERP
type string limit
side string buy
price number 10135.25
size number 0.001
filledSize number 0.001
remainingSize number 0.0
avgFillPrice number 10135.25
status string new (accepted but not processed yet), open, or closed (filled or cancelled)
createdAt string 2019-06-27T15:24:03.101197+00:00
reduceOnly boolean false
ioc boolean false
postOnly boolean false
clientId string optional; client order id

Get open trigger orders

Request

GET /conditional_orders?market={market}

Response

{
  "success": true,
  "result": [
    {
      "createdAt": "2019-03-05T09:56:55.728933+00:00",
      "error": null,
      "future": "XRP-PERP",
      "id": 50001,
      "market": "XRP-PERP",
      "orderId": null,
      "orderPrice": null,
      "reduceOnly": false,
      "side": "buy",
      "size": 0.003,
      "status": "open",
      "trailStart": null,
      "trailValue": null,
      "triggerPrice": 0.49,
      "triggeredAt": null,
      "type": "stop"
      "orderType": "market",
      "filledSize": 0,
      "avgFillPrice": null,
      "retryUntilFilled": false
  ]
}

Requires authentication.

Request parameters

Name Type Value Description
market string XRP-PERP optional; market to limit orders
type string stop optional; type of trigger order (stop, trailing_stop, or take_profit)

Response format

Name Type Value Description
createdAt string 2019-03-05T09:56:55.728933+00:00
error string null [DEPRECATED] error that occurred on most recent trigger, if exists; otherwise null
future string XRP-PERP
id number 50001
market string XRP-PERP
orderId number null [DEPRECATED] order id of the most recent trigger, if exixsts; otherwise null
orderPrice number 0.50 Limit price for stop limit and take profit limit orders; otherwise null
reduceOnly boolean false
side string buy
size number 31431.0
status string open Always open for this endpoint
trailStart number null trigger price - trail value; only for trailing stop orders
trailValue number null only for trailing stop orders
triggerPrice number 0.49 market price at which this order will trigger
triggeredAt string null time of first trigger. null if never triggered
type string stop Values are stop, trailing_stop, and take_profit
orderType string market Values are market, limit
filledSize number 0
avgFillPrice number null
retryUntilFilled boolean false Whether or not to keep re-triggering until filled

Get trigger order triggers

Request

GET /conditional_orders/{conditional_order_id}/triggers

Response

{
  "success": true,
  "result": [
    {
      "error": null,
      "filledSize": 4.0,
      "orderSize": 10.0,
      "orderId": 38066650,
      "time": "2020-01-19T09:23:36.570904+00:00"
    }
  ]
}

Requires authentication.

Response format

Name Type Value Description
time string 2019-03-05T09:56:55.728933+00:00
orderSize number 31431.0 null if order failed to place
filledSize number 0 null if order failed to place
orderId number null if order failed to place
error string null reason for order failing to be placed, null if successful

Get trigger order history

Request

GET /conditional_orders/history?market={market}

Response

{
  "success": true,
  "result": [
    {
      "createdAt": "2019-03-05T09:56:55.728933+00:00",
      "error": null,
      "future": "XRP-PERP",
      "id": 50000,
      "market": "XRP-PERP",
      "orderId": 2800000,
      "orderPrice": null,
      "reduceOnly": false,
      "side": "buy",
      "size": 31431,
      "status": "triggered",
      "trailStart": null,
      "trailValue": null,
      "triggerPrice": 0.37,
      "triggeredAt": 2019-03-06T03:26:53.268723+00:00,
      "type": "stop",
      "orderType": "market",
      "filledSize": 31431,
      "avgFillPrice": 0.3701,
      "orderStatus": "closed",
      "orderType": "market",
      "filledSize": 0,
      "avgFillPrice": null,
      "retryUntilFilled": false,
    },
  ],
  "hasMoreData": false,
}

Requires authentication.

Request parameters

Name Type Value Description
market string BTC-0329 optional; market to limit orders
start_time number 1559881511 optional; only fetch orders created after this time
end_time number 1559881511 optional; only fetch orders created before this time
side string buy optional; valid values are buy and sell.
type string trailing_stop optional; valid values are stop, trailing_stop, and take_profit.
orderType string limit optional; valid values are market and limit.
limit number 100 optional; default 100, maximum 100

Response format

Name Type Value Description
createdAt string 2019-03-05T09:56:55.728933+00:00
error string null [DEPRECATED] error that occurred on most recent trigger, if exists; otherwise null
future string XRP-PERP
id number 50001
market string XRP-PERP
orderId number null [DEPRECATED] order ID if this order has triggered; otherwise null
orderPrice number 0.50 Limit price for stop limit and take profit limit orders; otherwise null
reduceOnly boolean false
side string buy
size number 31431.0
status string open Values are open, cancelled, and triggered
trailStart number null trigger price - trail value; only for trailing stop orders
trailValue number null only for trailing stop orders
triggerPrice number 0.49 market price at which this order will trigger
triggeredAt string null time of first trigger. null if never triggered
type string stop Values are stop, trailing_stop, and take_profit
orderType string market Values are market and limit
filledSize number 31431
avgFillPrice number 0.3701
orderStatus string closed [DEPRECATED] status of most recent trigger's order: new, open or closed
orderType string market Values are market, limit
filledSize number 0
avgFillPrice number null
retryUntilFilled boolean false Whether or not to keep re-triggering until filled

Place order

Request

POST /orders

{
  "market": "XRP-PERP",
  "side": "sell",
  "price": 0.306525,
  "type": "limit",
  "size": 31431.0,
  "reduceOnly": false,
  "ioc": false,
  "postOnly": false,
  "clientId": null
}

Response

{
  "success": true,
  "result": {
    "createdAt": "2019-03-05T09:56:55.728933+00:00",
    "filledSize": 0,
    "future": "XRP-PERP",
    "id": 9596912,
    "market": "XRP-PERP",
    "price": 0.306525,
    "remainingSize": 31431,
    "side": "sell",
    "size": 31431,
    "status": "open",
    "type": "limit",
    "reduceOnly": false,
    "ioc": false,
    "postOnly": false,
    "clientId": null,
  }
}

Requires authentication.

Payload format

Name Type Value Description
market string XRP-PERP e.g. "BTC/USD" for spot, "XRP-PERP" for futures
side string sell "buy" or "sell"
price number 0.306525 Send null for market orders.
type string limit "limit" or "market"
size number 31431.0
reduceOnly boolean false optional; default is false
ioc boolean false optional; default is false
postOnly boolean false optional; default is false
clientId string null optional; client order id

Response format

Name Type Value Description
createdAt string 2019-03-05T09:56:55.728933+00:00
filledSize number 0.0
future string XRP-PERP
id number 9596912
market string XRP-PERP
price number 0.306525
remainingSize number 31431.0
side string sell
size number 31431.0
status string new (accepted but not processed yet), open, or closed (filled or cancelled)
type string limit
reduceOnly boolean false
ioc boolean false
postOnly boolean false
clientId string optional; client order id, if supplied

Place trigger order

Trigger orders include stop, trailing stop, and take profit.

Request

POST /conditional_orders
  • Stop
{
  "market": "XRP-PERP",
  "side": "sell",
  "triggerPrice": 0.306525,
  "size": 31431.0,
  "type": "stop",
  "reduceOnly": false,
}
  • Trailing stop
{
  "market": "XRP-PERP",
  "side": "sell",
  "trailValue": -0.05,
  "size": 31431.0,
  "type": "trailingStop",
  "reduceOnly": false,
}
  • Take profit
{
  "market": "XRP-PERP",
  "side": "buy",
  "triggerPrice": 0.367895,
  "size": 31431.0,
  "type": "takeProfit",
  "reduceOnly": false,
}

Response

{
  "success": true,
  "result": {
    "createdAt": "2019-03-05T09:56:55.728933+00:00",
    "future": "XRP-PERP",
    "id": 9596912,
    "market": "XRP-PERP",
    "triggerPrice": 0.306525,
    "orderId": null,
    "side": "sell",
    "size": 31431,
    "status": "open",
    "type": "stop",
    "orderPrice": null,
    "error": null,
    "triggeredAt": null,
    "reduceOnly": false,
    "orderType": "market",
    "retryUntilFilled": false,
  }
}

Requires authentication.

Payload format

Name Type Value Description
market string XRP-PERP
side string sell "buy" or "sell"
size number 31431.0
type string stop "stop", "trailingStop", "takeProfit"; default is stop
reduceOnly boolean false optional; default is false
retryUntilFilled boolean false Whether or not to keep re-triggering until filled. optional, default true for market orders

Additional parameters for stop loss orders

Name Type Value Description
triggerPrice number 0.306525
orderPrice number 0.3063 optional; order type is limit if this is specified; otherwise market

Additional parameters for trailing stop orders

Name Type Value Description
trailValue number -0.05 negative for "sell"; positive for "buy"

Additional parameters for take profit orders

Name Type Value Description
triggerPrice number 0.306525
orderPrice number 0.3067 optional; order type is limit if this is specified; otherwise market

Response format

Name Type Value Description
createdAt string 2019-03-05T09:56:55.728933+00:00
future string XRP-PERP
id number 9596912
market string XRP-PERP
triggerPrice number 0.306525
orderId number 123123 [DEPRECATED] ID of the order sent on the most recent trigger, if exists
side string sell
size number 31431.0
status string Values are open, cancelled, and triggered
type string stop
orderPrice number null price of the order sent when this stop loss triggered
error string null [DEPRECATED] error message for unsuccessful order placement when this stop loss triggered
triggeredAt string null time at which this stop loss order triggered
reduceOnly boolean false
orderType string market Values are market, limit
retryUntilFilled boolean false Whether or not to keep re-triggering until filled

Modify order

Request

POST /orders/{order_id}/modify

{
  "size": 31431,
  "price": 0.326525,
}

Response

{
  "success": true,
  "result": {
    "createdAt": "2019-03-05T11:56:55.728933+00:00",
    "filledSize": 0,
    "future": "XRP-PERP",
    "id": 9596932,
    "market": "XRP-PERP",
    "price": 0.326525,
    "remainingSize": 31431,
    "side": "sell",
    "size": 31431,
    "status": "open",
    "type": "limit",
    "reduceOnly": false,
    "ioc": false,
    "postOnly": false,
    "clientId": null,
  }
}

Please note that the order's queue priority will be reset, and the order ID of the modified order will be different from that of the original order. Also note: this is implemented as cancelling and replacing your order. There's a chance that the order meant to be cancelled gets filled and its replacement still gets placed.

Requires authentication.

Payload format

Name Type Value Description
price number 0.306525 optional; either price or size must be specified
size number 31431.0 optional; either price or size must be specified
clientId string order1 optional; client ID for the modified order

Response format

Name Type Value Description
createdAt string 2019-03-05T11:56:55.728933+00:00
filledSize number 0.0
future string XRP-PERP
id number 9596932
market string XRP-PERP
price number 0.326525
remainingSize number 31431.0
side string sell
size number 31431.0
status string new (accepted but not processed yet), open, or closed (filled or cancelled)
type string limit
reduceOnly boolean false
ioc boolean false
postOnly boolean false
clientId string optional; client order id, if supplied

Modify order by client ID

Request

POST /orders/by_client_id/{client_order_id}/modify

{
  "size": 31431,
  "price": 0.326525,
}

Response

{
  "success": true,
  "result": {
    "createdAt": "2019-03-05T11:56:55.728933+00:00",
    "filledSize": 0,
    "future": "XRP-PERP",
    "id": 9596932,
    "market": "XRP-PERP",
    "price": 0.326525,
    "remainingSize": 31431,
    "side": "sell",
    "size": 31431,
    "status": "open",
    "type": "limit",
    "reduceOnly": false,
    "ioc": false,
    "postOnly": false,
    "clientId": null,
  }
}

Please note that the order's queue priority will be reset, and the order ID of the modified order will be different from that of the original order. Also note: this is implemented as cancelling and replacing your order. There's a chance that the order meant to be cancelled gets filled and its replacement still gets placed.

Requires authentication.

Payload format

Name Type Value Description
price number 0.306525 optional; either price or size must be specified
size number 31431.0 optional; either price or size must be specified
clientId string order1 optional; client ID for the modified order

Response format

Name Type Value Description
createdAt string 2019-03-05T11:56:55.728933+00:00
filledSize number 0.0
future string XRP-PERP
id number 9596932
market string XRP-PERP
price number 0.326525
remainingSize number 31431.0
side string sell
size number 31431.0
status string new (accepted but not processed yet), open, or closed (filled or cancelled)
type string limit
reduceOnly boolean false
ioc boolean false
postOnly boolean false
clientId string optional; client order id, if supplied

Modify trigger order

Trigger orders include stop, trailing stop, and take profit.

Request

POST /conditional_orders/{order_id}/modify
  • Stop
{
  "triggerPrice": 0.306225,
  "size": 31431.0,
}
  • Trailing stop
{
  "trailValue": -0.06,
  "size": 31432.0,
}
  • Take profit
{
  "triggerPrice": 0.367885,
  "size": 31433.0,

}

Response

{
  "success": true,
  "result": {
    "createdAt": "2019-03-05T09:56:55.728933+00:00",
    "future": "XRP-PERP",
    "id": 9596912,
    "market": "XRP-PERP",
    "triggerPrice": 0.306225,
    "orderId": null,
    "side": "sell",
    "size": 31431,
    "status": "open",
    "type": "stop",
    "orderPrice": null,
    "error": null,
    "triggeredAt": null,
    "reduceOnly": false,
    "orderType": "market",
    "filledSize": 0,
    "avgFillPrice": null,
    "retryUntilFilled": false
  }
}

Requires authentication.

Payload format

Please note that the order ID of the modified order will be different from that of the original order.

Parameters for stop loss orders

Name Type Value Description
size number 31431.0
triggerPrice number 0.306525
orderPrice number 0.3063 only for stop limit orders

Parameters for trailing stop orders

Name Type Value Description
size number 31431.0
trailValue number -0.05 negative for sell orders; positive for buy orders

Parameters for take profit orders

Name Type Value Description
size number 31431.0
triggerPrice number 0.306525
orderPrice number 0.3067 only for take profit limit orders

Response format

Name Type Value Description
createdAt string 2019-03-05T12:56:55.728933+00:00
future string XRP-PERP
id number 9596912
market string XRP-PERP
triggerPrice number 0.306525
orderId number 123123 [DEPRECATED] ID of the order sent on the most recent trigger, if exists
side string sell
size number 31431.0
status string Values are open, cancelled, and triggered
type string stop
orderPrice number null price of the order sent when this stop loss triggered
error string null [DEPRECATED] error message for unsuccessful order placement of the most recent trigger, if exists
triggeredAt string null time at which this stop loss first triggered
reduceOnly boolean false
orderType string market Values are market, limit
retryUntilFilled boolean false Whether or not to keep re-triggering until filled

Get order status

Request

GET /orders/{order_id}

Response

{
  "success": true,
  "result": {
    "createdAt": "2019-03-05T09:56:55.728933+00:00",
    "filledSize": 10,
    "future": "XRP-PERP",
    "id": 9596912,
    "market": "XRP-PERP",
    "price": 0.306525,
    "avgFillPrice": 0.306526,
    "remainingSize": 31421,
    "side": "sell",
    "size": 31431,
    "status": "open",
    "type": "limit",
    "reduceOnly": false,
    "ioc": false,
    "postOnly": false,
    "clientId": null
  }
}

Get order status by client id

Request

GET /orders/by_client_id/{client_order_id}

Response

{
  "success": true,
  "result": {
    "createdAt": "2019-03-05T09:56:55.728933+00:00",
    "filledSize": 10,
    "future": "XRP-PERP",
    "id": 9596912,
    "market": "XRP-PERP",
    "price": 0.306525,
    "avgFillPrice": 0.306526,
    "remainingSize": 31421,
    "side": "sell",
    "size": 31431,
    "status": "open",
    "type": "limit",
    "reduceOnly": false,
    "ioc": false,
    "postOnly": false,
    "clientId": "your_client_order_id"
  }
}

Requires authentication.

Response format

Name Type Value Description
id number 9596912
market string XRP-PERP
type string limit
side string sell
price number 0.306525
size number 31431.0
filledSize number 10.0
remainingSize number 31421.0
avgFillPrice number 0.306526
status string new (accepted but not processed yet), open, or closed (filled or cancelled)
createdAt string 2019-03-05T09:56:55.728933+00:00
reduceOnly boolean false
ioc boolean false
postOnly boolean false
clientId string client order id

Cancel order

Request

DELETE /orders/{order_id}

Response

{
  "success": true,
  "result": "Order queued for cancelation"
}

Requires authentication.

Cancel order by client id

Request

DELETE /orders/by_client_id/{client_order_id}

Response

{
  "success": true,
  "result": "Order queued for cancellation"
}

Requires authentication.

Cancel open trigger order

Request

DELETE /conditional_orders/{id}

Response

{
  "success": true,
  "result": "Order cancelled"
}

Requires authentication.

Cancel all orders

This will also cancel conditional orders (stop loss and trailing stop orders).

Request

DELETE /orders

{
  "market": "BTC-PERP",
}

Response

{
  "success": true,
  "result": "Orders queued for cancelation"
}

Requires authentication.

Payload format

Name Type Value Description
market string USDTBEAR optional; restrict to cancelling orders only on this market
conditionalOrdersOnly boolean false optional; restrict to cancelling conditional orders only
limitOrdersOnly boolean false optional; restrict to cancelling existing limit orders (non-conditional orders) only

Convert

Request quote

Request

POST /otc/quotes

{
  "fromCoin": "BTC",
  "toCoin": "USD",
  "size": 0.05
}

Response

{
  "success": true,
  "result": {
    "quoteId": 1031
  }
}

Requires authentication.

Payload format

Name Type Value Description
fromCoin string BTC
toCoin string USD
size number 0.05 denominated in units of fromCoin

Response format

Name Type Value Description
quoteId number 1031

Get quote status

Request

GET /otc/quotes/{quoteId}

Response

{
  "success": true,
  "result": [
    {
      "baseCoin": "BTC"
      "cost": 0.05
      "expired": false,
      "filled": false,
      "fromCoin": "BTC",
      "id": 1031,
      "price": 7695.4,
      "proceeds": 384.77,
      "quoteCoin": "USD",
      "side": "sell",
      "toCoin": "USD"
    }
  ]
}

Requires authentication.

Request parameters

Name Type Value Description
market string BTC/USD optional; market to limit orders

Response format

Name Type Value Description
baseCoin string BTC
cost number 0.05 cost of accepting the quote in units of fromCoin
expired bool false if the quote is expired (if so, cannot accep tit)
filled bool false if the quote is already accepted
id number 1031
price number 7695.4 price in units of quoteCoin
proceeds number 384.77 proceeds of accepting the quote in units of toCoin
quoteCoin string USD
side string "sell" "sell" if fromCoin is baseCoin, otherwise "buy"
toCoin string USD

Accept quote

Request

POST /otc/quotes/{quote_id}/accept

Response

{
  "success": true,
  "result": null
}

Requires authentication.

Payload format

Name Type Value Description
quoteId number 1031

Fills

Request

GET /fills?market={market}

Response

{
  "success": true,
  "result": [
    {
      "fee": 20.1374935,
      "feeCurrency": "USD",
      "feeRate": 0.0005,
      "future": "EOS-0329",
      "id": 11215,
      "liquidity": "taker",
      "market": "EOS-0329",
      "baseCurrency": null,
      "quoteCurrency": null,
      "orderId": 8436981,
      "tradeId": 1013912,
      "price": 4.201,
      "side": "buy",
      "size": 9587,
      "time": "2019-03-27T19:15:10.204619+00:00",
      "type": "order"
    }
  ]
}

Requires authentication.

Request parameters

Name Type Value Description
market string BTC-0329 optional; market to limit fills
limit number 20 optional; number of fills to return
start_time number 1564146934 optional; minimum time of fills to return, in Unix time (seconds since 1970-01-01)
end_time number 1564233334 optional; maximum time of fills to return, in Unix time (seconds since 1970-01-01)
order string null optional; default is descending, supply 'asc' to receive fills in ascending order of time
orderId number null

Response format

Name Type Value Description
fee number 20.1374935
feeCurrency string USD
feeRate number 0.0005
future string EOS-0329
id number 11215 fill id
liquidity string taker "taker" or "maker"
market string EOS-0329
baseCurrency string BTC spot markets only
quoteCurrency string USD spot markets only
orderId number 8436981
tradeId number 1013912 null for trades before 2019-02-19 10:00:00
price number 4.201
side string buy
size number 9587.0
time string 2019-03-27T19:15:10.204619+00:00
type string order

Funding Payments

Request

GET /funding_payments
Name Type Value Description
start_time number 1559881511 optional
end_time number 1559881711 optional
future string BTC-PERP optional

Response

{
  "success": true,
  "result": [
    {
      "future": "ETH-PERP",
      "id": 33830,
      "payment": 0.0441342,
      "time": "2019-05-15T18:00:00+00:00",
      "rate": 0.0001
    }
  ]
}

Requires authentication.

Response format

Name Type Value Description
future string ETH-PERP
id number 33830
payment number 0.0441342
time string 2019-05-15T18:00:00+00:00

Leveraged Tokens

List leveraged tokens

Request

GET /lt/tokens

Response

{
  "success": true,
  "result": [
    {
      "name": "HEDGE",
      "description": "1x Short Bitcoin Token",
      "underlying": "BTC-PERP",
      "leverage": -1,
      "outstanding": 1100.72231577,
      "pricePerShare": 2736.375887408888,
      "positionPerShare": -0.35783866135616976,
      "underlyingMark": 7605.25,
      "contractAddress": "0x1FA3bc860bF823d792f04F662f3AA3a500a68814",
      "change1h": 0.00035975425246481245,
      "change24h": 0.02595729864870652
    }
  ]
}

Response format

Name Type Value Description
name string HEDGE name of the token
description string 1x Short Bitcoin Token
underlying string BTC-PERP name of the underlying futures contract used by this token
leverage number -1
outstanding number 1100.72231577 number of outstanding tokens
pricePerShare number 2736.375887408888 price of each token, using the current mark price of the underlying future
positionPerShare number -0.35783866135616976 underlying futures position held by each token
underlyingMark number 7605.25 current mark price of the underlying future
contractAddress string 0x1FA3bc860bF823d792f04F662f3AA3a500a68814 ERC20 smart contract address of the token
change1h number 0.00035975425246481245 change in the price of the token over the past hour
change24h number 0.02595729864870652 change in the price of the token over the past day

Get token info

Request

GET /lt/{token_name}

Response

{
  "success": true,
  "result": {
    "name": "HEDGE",
    "description": "1x Short Bitcoin Token",
    "underlying": "BTC-PERP",
    "leverage": -1,
    "outstanding": 1100.72231577,
    "pricePerShare": 2736.375887408888,
    "positionPerShare": -0.35783866135616976,
    "underlyingMark": 7605.25,
    "contractAddress": "0x1FA3bc860bF823d792f04F662f3AA3a500a68814",
    "change1h": 0.00035975425246481245,
    "change24h": 0.02595729864870652
  }
}

Parameters

Name Type Value Description
token_name string HEDGE Required. Name of the token.

Response format

Name Type Value Description
name string HEDGE name of the token
description string 1x Short Bitcoin Token
underlying string BTC-PERP name of the underlying futures contract used by this token
leverage number -1
outstanding number 1100.72231577 number of outstanding tokens
pricePerShare number 2736.375887408888 price of each token, using the current mark price of the underlying future
positionPerShare number -0.35783866135616976 underlying futures position held by each token
underlyingMark number 7605.25 current mark price of the underlying future
contractAddress string 0x1FA3bc860bF823d792f04F662f3AA3a500a68814 ERC20 smart contract address of the token
change1h number 0.00035975425246481245 change in the price of the token over the past hour
change24h number 0.02595729864870652 change in the price of the token over the past day

Get leveraged token balances

Request

GET /lt/balances

Response

{
  "success": true,
  "result": [
    {
      "token": "HEDGE",
      "balance": 8.8
    }
  ]
}

Requires authentication.

Response format

Name Type Value Description
token string HEDGE
balance number 8.8

List leveraged token creation requests

Request

GET /lt/creations

Response

{
  "success": true,
  "result": [
    {
      "id": 123,
      "token": "HEDGE",
      "requestedSize": 10,
      "pending": false,
      "createdSize": 10,
      "price": 1234,
      "cost": 12340,
      "fee": 12.34,
      "requestedAt": "2019-03-05T09:56:55.728933+00:00",
      "fulfilledAt": "2019-03-05T09:56:55.728933+00:00"
    }
  ]
}

Requires authentication.

Response format

Name Type Value Description
id number 123
token string HEDGE name of the token
requestedSize number 10 number of tokens originally requested
pending boolean false
createdSize number 10 number of tokens created; may be less than the requested number
price number 1234 price at which the creation request was fulfilled
cost number 12340 cost of creating the tokens, not including fees
fee number 12.34 fee for creating the tokens
requestedAt string 2019-03-05T09:56:55.728933+00:00 time the request was submitted
fulfilledAt string 2019-03-05T09:56:55.728933+00:00 time the request was processed

Request leveraged token creation

Request

POST /lt/{token_name}/create

{
  "size": 31431.0
}

Response

{
  "success": true,
  "result": {
    "id": 123,
    "token": "HEDGE",
    "requestedSize": 10,
    "cost": 12340,
    "pending": true,
    "requestedAt": "2019-03-05T09:56:55.728933+00:00"
  }
}

Requires authentication.

Request parameters

Name Type Value Description
token_name string HEDGE required; name of the token

Payload format

Name Type Value Description
size number 31431.0 number of tokens to create

Response format

Name Type Value Description
id number 123
token string HEDGE name of the token
requestedSize number 10 number of tokens requested
cost number 12340 amount of collateral deducted for the creation request
pending boolean true
requestedAt string 2019-03-05T09:56:55.728933+00:00 time the request was submitted

List leveraged token redemption requests

Request

GET /lt/redemptions

Response

{
  "success": true,
  "result": [
    {
      "id": 123,
      "token": "HEDGE",
      "size": 10,
      "pending": false,
      "price": 1234,
      "proceeds": 12340,
      "fee": 12.34,
      "requestedAt": "2019-03-05T09:56:55.728933+00:00",
      "fulfilledAt": "2019-03-05T09:56:55.728933+00:00"
    }
  ]
}

Requires authentication.

Response format

Name Type Value Description
id number 123
token string HEDGE name of the token
size number 10 number of tokens redeemed
pending boolean false
price number 1234 price at which the redemption request was fulfilled
proceeds number 12340 proceeds from the redemption, before fees
fee number 12.34 fee for redeeming the tokens
requestedAt string 2019-03-05T09:56:55.728933+00:00 time the request was submitted
fulfilledAt string 2019-03-05T09:56:55.728933+00:00 time the request was processed

Request leveraged token redemption

Request

POST /lt/{token_name}/redeem

{
  "size": 31431.0
}

Response

{
  "success": true,
  "result": {
    "id": 123,
    "token": "HEDGE",
    "size": 10,
    "projectedProceeds": 12340,
    "pending": true,
    "requestedAt": "2019-03-05T09:56:55.728933+00:00"
  }
}

Requires authentication.

Request parameters

Name Type Value Description
token_name string HEDGE required; name of the token

Payload format

Name Type Value Description
size number 31431.0 number of tokens to create

Response format

Name Type Value Description
id number 123
token string HEDGE - name of the token
size number 10 - number of tokens requsted to be redeemed
projectedProceeds number 12340 - estimated proceeds from the redemption
pending boolean true
requestedAt string 2019-03-05T09:56:55.728933+00:00 - time the request was submitted

Options

List quote requests

Request

GET /options/requests

Response

{
  "success": true,
  "result": [
    {
      "id": 512,
      "option": {
        "underlying": "BTC",
        "type": "call",
        "strike": 7800,
        "expiry": "2020-01-08T03:00:00+00:00",
      },
      "side": "buy",
      "size": 1.2,
      "time": "2020-01-07T22:35:54.626023+00:00",
      "requestExpiry": "2020-01-08T22:35:54.626023+00:00",
      "status": "open",
    },
  ],
}

Response format

Name Type Value Description
id number 512
option dict option object; see below
size number 1.2
side string buy
time string 2020-01-07T22:35:54.626023+00:00 when the request was placed
status string open
requestExpiry string 2020-01-08T22:35:54.626023+00:00 when the request expires
limitPrice number 10.2 optional; omitted when the request has no limit price or it is hidden

Note that option objects have the following format:

Name Type Value Description
underlying string BTC
type string call "call" or "put"
strike number 7800
expiry string 2020-01-08T03:00:00+00:00

Your quote requests

Requires authentication.

Request

GET /options/my_requests

Response

{
  "success": true,
  "result": [
    {
      "id": 512,
      "option": {
        "underlying": "BTC",
        "type": "call",
        "strike": 7800,
        "expiry": "2020-01-08T03:00:00+00:00",
      },
      "side": "buy",
      "size": 1.2,
      "time": "2020-01-07T22:35:54.626023+00:00",
      "requestExpiry": "2020-01-08T22:35:54.626023+00:00",
      "status": "open",
      "hideLimitPrice": true,
      "limitPrice": 1.2,
      "quotes": [
        {
          "collateral": 8762.71757981,
          "id": 1029,
          "price": 1.0,
          "quoteExpiry": null,
          "status": "open",
          "time": "2020-01-07T22:49:31.367379+00:00".
        },
      ],
    },
  ],
}

Response format

Name Type Value Description
id number 512
option dict option object; see List Quote Requests section
side string buy
size number 1.2
time string 2020-01-07T22:35:54.626023+00:00 when the request was placed
status string open
requestExpiry string 2020-01-08T22:35:54.626023+00:00 when the request expires
quotes array list of quotes for your quote request; see below
hideLimitPrice bool true whether or not to hide your limit price if it exists
limitPrice number 1.2 optional; omitted if your request does not have a limit price

Note that quote objects have the following format:

Name Type Value Description
id number 1029
status string open
collateral number 8762.71757981 collateral locked by the quote
price number 1.0
quoteExpiry string null optional
time string 2020-01-07T22:49:31.367379+00:00 when the quote was created

Create quote request

Request

Requires authentication.

POST /options/requests

{
  "underlying": "BTC",
  "type": "call",
  "strike": 7800,
  "expiry": 1578625200,
  "side": "buy",
  "size": 5,
}

Payload format

Name Type Value Description
underlying string BTC
type string call "call" or "put"
strike number 7800
expiry number 1578625200 unix timestamp of option expiry. Must be in the future and at 03:00 UTC.
side string buy "buy" or "sell"
size number 5
limitPrice number 1.2 optional limit price
hideLimitPrice bool true whether or not to hide your limit price from potential quoters, default true
requestExpiry number null optional; unix timestamp of request expiry, defaults to 5 minutes in the future
counterpartyId number 1234567 optional; when specified, makes the request private to the specified counterparty

Response

{
  "success": true,
  "result": {
    "id": 3,
    "option": {
      "expiry": "2020-01-10T03:00:00+00:00",
      "strike": 7800,
      "type": "call",
      "underlying": "BTC"
    },
    "expiry": "2020-01-10T03:00:00+00:00",
    "strike": 7800,
    "type": "call",
    "underlying": "BTC",
    "requestExpiry": "2020-01-08T23:05:44.047653+00:00",
    "side": "buy",
    "size": 5,
    "status": "open",
    "time": "2020-01-07T23:05:44.047653+00:00"
  },
}

Cancel quote request

Requires authentication.

Request

DELETE /options/requests/{request_id}

Response

{
  "id": 3,
  "option": {
    "expiry": "2020-01-10T03:00:00+00:00",
    "strike": 7800.0,
    "type":"call",
    "underlying": "BTC"
  },
  "requestExpiry": "2020-01-08T23:05:44.047653+00:00",
  "side": "buy",
  "size": 5.0,
  "status": "cancelled",
  "time": "2020-01-07T23:05:44.047653+00:00",
}

Get quotes for your quote request

Requires authentication.

Request

GET /options/requests/{request_id}/quotes

Response

{
  "success": true,
  "result": {
    "collateral": 26862.33468643,
    "id": 2,
    "option": {
      "expiry": "2020-01-08T03:00:00+00:00",
      "strike"': 10.0,
      "type": "call",
      "underlying": "BTC"
    },
    "price": 11.0,
    "quoteExpiry": null,
    "quoterSide": "sell",
    "requestId": 4,
    "requestSide": "buy",
    "size": 3.0,
    "status": "open",
    "time": "2020-01-07T23:43:24.772581+00:00"
  },
}
Name Type Value Description
id number 2 id of the quote
requestId number 4 id of the quote request
status string open
collateral number 26862.33468643 collateral locked by the quote
price number 11.0
quoteExpiry string null optional
quoterSide string sell
requestSide string buy
size number 3.0
time string 22020-01-07T23:43:24.772581+00:00 when the quote was created
option option object; see List Quote Requests section
requestLimitPrice number null the quote request's limit price. omitted if does not exist or hidden

Create quote

Requires authentication.

Request

POST  /options/requests/{request_id}/quotes

{
  "price": 11.0,
}

Payload format

Name Type Value Description
price number 11.0 price of your quote

Response

{
  "success": true,
  "result": {
    "collateral": 26862.33468643,
    "id": 2,
    "option": {
      "expiry": "2020-01-08T03:00:00+00:00",
      "strike"': 10.0,
      "type": "call",
      "underlying": "BTC"
    },
    "price": 11.0,
    "quoteExpiry": null,
    "quoterSide": "sell",
    "requestId": 4,
    "requestSide": "buy",
    "size": 3.0,
    "status": "open",
    "time": "2020-01-07T23:43:24.772581+00:00"
  },
}

Get my quotes

Requires authentication.

Request

GET /options/my_quotes

Response

{
  "success": true,
  "result": {
    "collateral": 26862.33468643,
    "id": 2,
    "option": {
      "expiry": "2020-01-08T03:00:00+00:00",
      "strike"': 10.0,
      "type": "call",
      "underlying": "BTC"
    },
    "price": 11.0,
    "quoteExpiry": null,
    "quoterSide": "sell",
    "requestId": 4,
    "requestSide": "buy",
    "size": 3.0,
    "status": "open",
    "time": "2020-01-07T23:43:24.772581+00:00"
  },
}

Cancel quote

Requires authentication.

Request

DELETE /options/quotes/<quote_id>

Response

{
  "success": true,
  "result": {
    "collateral": 0,
    "id": 4,
    "option": {
      "expiry": "2020-01-08T03:00:00+00:00",
      "strike": 7800,
      "type": "call",
      "underlying": "BTC",
    },
    "price": 11,
    "quoteExpiry": null,
    "quoterSide": "sell",
    "requestId": 4,
    "requestSide": "buy",
    "size": 3,
    "status": "cancelled",
    "time": "2020-01-08T00:20:00.532812+00:00",
  },
}

Accept options quote

Requires authentication.

Request

POST /options/quotes/<quote_id>/accept

Response

{
  "success": true,
  "result": {
    "collateral": 0,
    "id": 5,
    "option": {
      "expiry": "2020-01-08T03:00:00+00:00",
      "strike": 7800,
      "type": "call",
      "underlying": "BTC",
    },
    "price": 11,
    "quoteExpiry": null,
    "quoterSide": "sell",
    "requestId": 4,
    "requestSide": "buy",
    "size": 3,
    "status": "filled",
    "time": "2020-01-08T00:20:00.532812+00:00",
  },
}

Get account options info

Requires authentication.

Request

GET /options/account_info

Response

{
  "success": true,
  "result": {
    "usdBalance": 34.0,
    "liquidationPrice": 1900.2,
    "liquidating": false,
  },
}
Name Type Value Description
usdBalance number 34.0
liquidationPrice number 1900.2 estimated liquidation price
liquidated boolean false if the account is currently liquidating
maintenanceMarginRequirement number 1200.12 you will be liquidated if your account collateral + options usdBalance drops below this number
initialMarginRequirement number 1523.13

Get options positions

Requires authentication.

Request

GET /options/positions

Response

{
  "success": true,
  "result": [
    {
      "entryPrice": 11.0,
      "netSize": 3.0,
      "option": {
        "expiry": "2020-01-08T03:00:00+00:00",
        "strike": 7800,
        "type": "call",
        "underlying": "BTC",
      },
      "side": "buy",
      "size": 3,
    },
  ]
}
Name Type Value Description
netSize number 3.0 positive if long, negative if short
entryPrice number 11.0 average entry price
size number 3.0 absolute value of netSize
option option object; see List Quote Requests section
side string buy "buy" if long, "sell" if short
pessimisticValuation number 1.1 optional; pessimistic valuation of this position used for margin purposes
pessimisticIndexPrice number 6280 optional; index price corresponding to pessimistic valuation
pessimisticVol number 0.17 optional; vol corresponding to pessimistic valuation

Get public options trades

Request

GET /options/trades

Request parameters

Name Type Value Description
start_time number 1559881511 optional; only fetch orders created after this time
end_time number 1559901511 optional; only fetch orders created before this time
limit number 100 optional; default 20, maximum 200

Response

{
  "success": true,
  "result": [
    {
      "id": 31,
      "option": {
        "expiry": "2020-01-08T03:00:00+00:00",
        "strike": 7800,
        "type": "call",
        "underlying": "BTC",
      },
      "price": 3,
      "size": 1,
      "time": "2020-01-08T02:59:57.270744+00:00",
    },
  ]
}
Name Type Value Description
id number 31
size number 1.0
price number 3.0
option option object; see List Quote Requests section
time string "2020-01-08T02:59:57.270744+00:00"

Get options fills

Requires authentication.

Request

GET /options/fills

Request parameters

Name Type Value Description
start_time number 1559881511 optional; only fetch orders created after this time
end_time number 1559901511 optional; only fetch orders created before this time
limit number 100 optional; default 20, maximum 200

Response

{
  "success": true,
  "result": [
    {
      "fee": 1.782852614186007,
      "feeRate": 0.0001729,
      "id": 5,
      "liquidity": "taker",
      "option": {
        "expiry": "2020-01-08T03:00:00+00:00",
        "strike": 7800,
        "type": "call",
        "underlying": "BTC"
      },
      "price": 3,
      "quoteId": 6,
      "side": "sell",
      "size": 1,
      "time": "2020-01-08T02:59:57.270744+00:00",
    },
  ]
}
Name Type Value Description
id number 5
size number 1.0
price number 3.0
option option object; see List Quote Requests section
time string "2020-01-08T02:59:57.270744+00:00"
liquidity string taker "taker" or "maker"
fee number 1.782852614186007
feeRate number 0.0001729
side string buy

Get 24h option volume

Request

GET /stats/24h_options_volume

Response

{
  "success": true,
  "result": [
    {
    "contracts": 216.6842,
    "underlying_total": 2111838.071037173,
    }
  ]

}
Name Type Value Description
contracts number 216.6842 Number of contracts traded over the last 24 hours
underlying_total number 2111838.071037173 Notional value of the contracts traded over the last 24 hours

Get option open interest

Request

GET /options/historical_volumes/BTC

Request parameters

Name Type Value Description
start_time number 1559881511 optional; only fetch orders created after this time
end_time number 1559901511 optional; only fetch orders created before this time
limit number 100 optional; maximum 200

Response

{
    "success": true,
    "result": [
        {
            "numContracts": 1.0,
            "endTime": "2020-07-01T04:06:00.584303+00:00",
            "startTime": "2020-07-01T03:06:00.543341+00:00"
        }
    ]
}
Name Type Value Description
numContracts number 12572.0898 Volume (in BTC)
endTime string "2020-07-01T04:06:00.584303+00:00"
startTime string "2020-07-01T03:06:00.543341+00:00"

Get option open interest

Request

GET /options/open_interest/BTC

Response

{
  "success": true,
  "result": {
    "openInterest": 12572.0898
  }
}
Name Type Value Description
openInterest number 12572.0898 Open interest (in BTC)

Get option open interest

Request

GET options/historical_open_interest/BTC

Request parameters

Name Type Value Description
start_time number 1559881511 optional; only fetch orders created after this time
end_time number 1559901511 optional; only fetch orders created before this time
limit number 100 optional; maximum 200

Response

{
    "success": true,
    "result": [
        {
            "numContracts": 5870.6395,
            "time": "2020-07-01T04:06:00.589877+00:00"
        }
    ]
}
Name Type Value Description
numContracts number 12572.0898 Open interest (in BTC)
time string "2020-07-01T04:06:00.589877+00:00"

Websocket API

Streaming API with the most up-to-date market and account order data. With this API, you can send messages to a server and receive event-driven responses without having to poll the server for a reply.

Websocket endpoint URL: wss://ftx.com/ws/

Requests and responses use JSON.

You can find sample code here: https://github.com/ftexchange/ftx

Request process

Websocket connections go through the following lifecycle: - Establish a websocket connection with wss://ftx.com/ws/ - (Optional) Authenticate with {'op': 'login', 'args': {'key': <api_key>, 'sign': <signature>, 'time': <ts>}} - Send pings at regular intervals (every 15 seconds): {'op': 'ping'}. You will see an {'type': 'pong'} response. - Subscribe to a channel with {'op': 'subscribe', 'channel': 'trades', 'market': 'BTC-PERP'} - Receive subscription response {'type': 'subscribed', 'channel': 'trades', 'market': 'BTC-PERP'} - Receive data {'type': 'update', 'channel': 'trades', 'market': 'BTC-PERP', 'data': {'bid': 5230.5, 'ask': 5231.0, 'ts': 1557133490.4047449, 'last': 5230.5}} - Unsubscribe {'op': 'unsubscribe', 'channel': 'trades', 'market': 'BTC-PERP'} - Receive unsubscription response {'type': 'unsubscribed', 'channel': 'trades', 'market': 'BTC-PERP'}

Request format

Messages sent to the server should contain the following dictionary items:

Response format

Public Channels

Ticker

The ticker channel provides the latest best bid and offer market data. All messages are updates (update), and the data field contains: - bid: Best bid price if a bid exists, else null - ask: Best ask price if an ask exists, else null - last: Last trade price if it exists, else null - time: Timestamp

Markets

The markets channel provides information on the full set of tradable markets and their specifications. After subscription and whenever any market lists, delsists, or changes, you will receive a partial message with information on all markets. The data field both types of messages will contain a list of market information dictionaries, each of which contains:

Trades

The trades channel provides data on all trades in the market. All messages are updates of new trades (update) and the data field contains: - price: Price of the trade - size: Size of the trade - side: Side of the taker in the trade - liquidation: true if the trade involved a liquidation order, else false - time: Timestamp

Orderbooks

The orderbook channel provides data about the orderbook's best 100 orders on either side.

Initial snapshot

Upon subscribing, you will receive one snapshot of the orderbook (partial) with a data field containing:

The bids and asks are formatted like so: [[best price, size at price], [next next best price, size at price], ...]

Updates

After receiving your snapshot, you will be streamed updates (message type is update) that have data fields with:

The bids and asks fields contain updates to the orderbook.

Checksum

Every message contains a signed 32-bit integer checksum of the orderbook. You can run the same checksum on your client orderbook state and compare it to checksum field. If they are the same, your client's state is correct. If not, you have likely lost or mishandled a packet and should re-subscribe to receive the initial snapshot.

The checksum operates on a string that represents the first 100 orders on the orderbook on either side. The format of the string is:

For example, if the orderbook was comprised of the following two bids and asks:

The string would be '5005.5:10:5001.0:6:4995.0:5:5002.0:7'

If there are more orders on one side of the book than the other, then simply omit the information about orders that don't exist.

For example, if the orderbook had the following bids and asks:

The string would be '5005.5:10:5001.0:6:4995.0:5'

The final checksum is the crc32 value of this string.

Grouped Orderbooks

The grouped orderbooks channel supplies orderbook data with grouped (collapsed) prices.

Disclaimer

Please note that we do NOT recommend using the grouped orderbooks channel in general: it should only be used for retrieving lower-granularity, possibly higher-depth information about the orderbook.

Subscribing

To subscribe, send a message specifying market and price grouping: {'channel': 'orderbookGrouped', 'market': 'BTC-PERP', 'grouping': 500}. grouping controls the granularity of price levels reported by the channel.

Messages

All messages from the orderbookGrouped channel contain two fields: bids and asks. Each are formatted like so: [[best (grouped) price, size at price], [next next best price, size at price], ...].

The first message you are sent will contain a snapshot of the whole orderbook.

Subsequent messages only contain updates. For instance if you received the message: {'bids': [[9000, 1780.0]], 'asks': []}, you should interpret that as meaning that since the last update you received, the only thing that has changed is that the total bid size at the 9000 level is now 1780.0.

Note that the price groupings are conservative: with a price grouping of 100, the size for a bid at 9395.5 would be attributed to the 9300 level, and the size for an ask at the same price would be attributed to the 9400 level.

Private Channels

Authentication

You can log in by sending a message like so %{code}

{
  "args": {
    "key": "<api_key>",
    "sign": "<signature>",
    "time": <ts>
  },
  "op": "login"
}

As an example, if:

sign would be d10b5a67a1a941ae9463a60b285ae845cdeac1b11edc7da9977bef0228b96de9

One websocket connection may be logged in to at most one user. If the connection is already authenticated, further attempts to log in will result in 400s.

Fills

You will receive messages so:

{
  "channel": "fills",
  "data": {
    "fee": 78.05799225,
    "feeRate": 0.0014,
    "future": "BTC-PERP",
    "id": 7828307,
    "liquidity": "taker",
    "market": "BTC-PERP",
    "orderId": 38065410,
    "tradeId": 19129310,
    "price": 3723.75,
    "side": "buy",
    "size": 14.973,
    "time": "2019-05-07T16:40:58.358438+00:00",
    "type": "order"
  },
  "type": "update"
}

This channel streams your fills across all markets. You can subscribe to it on an authenticated connection by sending {'op': 'subscribe', 'channel': 'fills'}.

Orders

You will receive messages so:

{
  "channel": "orders",
  "data": {
    "id": 24852229,
    "clientId": null,
    "market": "XRP-PERP",
    "type": "limit",
    "side": "buy",
    "size": 42353.0,
    "price": 0.2977,
    "reduceOnly": false,
    "ioc": false,
    "postOnly": false,
    "status": "closed",
    "filledSize": 0.0,
    "remainingSize": 0.0,
    "avgFillPrice": 0.2978
  },
  "type": "update"
}

This channel streams updates to your orders across all markets. You can subscribe to it on an authenticated connection by sending {'op': 'subscribe', 'channel': 'orders'}.

FIX API

FIX (Financial Information eXchange) is a standard electronic messaging protocol which can be used to place orders, receive order updates and executions, and cancel orders. Our FIX api is based on the FIX 4.2 specification and modeled after FIX implementations of other popular cryptocurrency exchanges.

You can find sample client code here: https://github.com/ftexchange/ftx

FIX endpoint URL: tcp+ssl://fix.ftx.com:4363

Clients should connect to the endpoint using SSL.

Sequence numbers are reset for each connection. Resend request and sequence reset messages are not supported.

Messages

8=FIX.4.2|9=162|35=A|49=zyfvB4QPg0A3kkVgqUE9V1fOA-Y6jhdG3seqIIZx|56=FTX

All messages should include the following header:

This documentation uses | to represent the FIX field separator (byte 0x01). It should be replaced by 0x01 in actual messages.

Tag Name Example Description
8 BeginString FIX.4.2 Must be set to "FIX.4.2"
9 BodyLength 162 Length of the message body in bytes
35 MsgType 8 Message type
49 SenderCompID zyfvB4QPg0A3kkVgqUE9V1fOA-Y6jhdG3seqIIZx Client API key (for messages from the client)
56 TargetCompID FTX Must be set to "FTX" (for messages from the client) 
34=1|52=20190525-07:17:48

Messages should also include a sequence number MsgSeqNum (34) and a timestamp SendingTime (52). Sequence numbers start at 1 and must be incremented with every message. Messages with duplicate or out-of-order sequence numbers will be rejected. Sequence numbers are reset on new connections.

Logon (A)

Sent by the client to initiate a FIX session. Must be the first message sent after a connection is established. Only one session can be established per connection; additional Logon messages are rejected.

Request

8=FIX.4.2|9=162|35=A|49=zyfvB4QPg0A3kkVgqUE9V1fOA-Y6jhdG3seqIIZx|56=FTX|34=1|52=20190525-07:51:51|98=0|108=30|96=8f7e7d37f8033ad249c1833687c230b6f4663f0dd72752899776bab9aa064783|10=237|
Tag Name Example Description
35 MsgType A
98 EncryptMethod 0 Must be set to "0" (None)
108 HeartBInt 30 Must be set to "30"
96 RawData 8f7e...4783 Signature (see below)
8013 CancelOrdersOnDisconnect Y "Y": all account orders will be cancelled at the end of the session. "S": all orders placed during the session will be cancelled at the end of the session. Default: no orders will be cancelled.
1 Account "my_subaccount" Optional subaccount name; can be omitted if authenticating for main account

Signature

from datetime import datetime
import hmac

api_key = 'YOUR_API_KEY'
api_secret = 'YOUR_API_SECRET'

sending_time = datetime.now().strftime('%Y%m%d-%H:%M:%S')

sign_target = '\x01'.join([
    sending_time,  # SendingTime
    'A',  # MsgType
    '1',  # MsgSeqNum
    api_key,  # SenderCompID
    'FTX',  # TargetCompID
])

signature = hmac.new(api_secret.encode(), sign_target.encode(), 'sha256').hexdigest()


let crypto = require('crypto');

let apiKey = 'YOUR_API_KEY';
let apiSecret = 'YOUR_API_SECRET';

let sendingTime = '20190525-07:51:51';

let signTarget = [
    sendingTime,  // SendingTime
    'A',  // MsgType
    '1',  // MsgSeqNum
    apiKey,  // SenderCompID
    'FTX',  // TargetCompID
].join('\x01');

let hmac = crypto.createHmac('sha256', apiSecret);
let signature = hmac.update(signTarget).digest('hex');

For security, the Logon message must be signed by the client. To compute the signature, concatenate the following fields, joined by the FIX field separator (byte 0x01), and compute the SHA256 HMAC using the API secret:

The resulting hash should be hex-encoded.








Response

8=FIX.4.2|9=98|35=A|49=FTX|56=zyfvB4QPg0A3kkVgqUE9V1fOA-Y6jhdG3seqIIZx|34=1|98=0|108=30|52=20190525-07:51:51.838|10=099
Tag Name Value
35 MsgType A
98 EncryptMethod 0
108 HeartBInt 30

Heartbeat (0)

Sent by either side if a message has not been received in the past 30 seconds. Should also be sent in response to a TestRequest (1). 

8=FIX.4.2|9=86|35=1|49=zyfvB4QPg0A3kkVgqUE9V1fOA-Y6jhdG3seqIIZx|56=FTX|34=2|52=20190525-07:52:24.029|10=049|
Tag Name Value Description
35 MsgType 0
112 TestReqID 123 If this heartbeat is in response to a TestRequest, copied from the TestRequest.

Test Request (1)

May be sent by either side at any time.

8=FIX.4.2|9=112|35=1|49=zyfvB4QPg0A3kkVgqUE9V1fOA-Y6jhdG3seqIIZx|56=FTX|34=3|112=20190525-08:26:38.989|52=20190525-08:26:38.989|10=140|
Tag Name Value Description
35 MsgType 1
112 TestReqID 123 Arbitrary string, to be echoed back by a Heartbeat.

Logout (5)

Sent by either side to terminate the session. The other side should respond with another Logout message to acknowledge session termination. The connection will be closed afterwards.

Tag Name Value
35 MsgType 5

New Order Single (D)

Sent by the client to submit a new order. Only limit orders are currently supported by the FIX API.

Tag Name Value Description
35 MsgType D
21 HandlInst 1 Must be set to "1" (AutomatedExecutionNoIntervention)
11 ClOrdID order123 Arbituary client-selected string to identify the order; must be unique
55 Symbol BTC-PERP Symbol name
40 OrdType 2 Must be set to "2" (Limit)
38 OrderQty 1.1 Order size in base units
44 Price 8000 Limit price
54 Side 1 "1": buy; "2": sell
59 TimeInForce 1 Must be set to "1" (Good Till Cancel) or "3" (Immediate or Cancel)
18 ExecInst E This paramter is optional. "E": reduce only, "6": post only, not supplied: standard

If the order is accepted, an ExecutionReport (8) with ExecType=A (Pending New) will be returned. Otherwise, an ExecutionReport with ExecType=8 (Rejected) will be returned.

Order Cancel Request (F)

Sent by the client to request to cancel an order.

Tag Name Value Description
35 MsgType F
37 OrderID 123456 System-assigned order ID of the order
41 OrigClOrdID order123 Client-assigned order ID of the order

Only one of OrderID (37) and OrigClOrdID (41) should be provided.

If the order is successfully cancelled, an ExecutionReport (8) with ExecType=6 (Pending Cancel) will be returned. Otherwise, an OrderCancelReject (9) will be returned.

Order Cancel Reject (9)

Sent by the server to notify the client that an OrderCancelRequest (F) failed.

Tag Name Value Description
35 MsgType 9
11 ClOrdID cancel123 Copied from OrderCancelRequest
37 OrderID 123456 Copied from OrderCancelRequest
41 OrigClOrdID order123 Copied from OrderCancelRequest
39 OrdStatus 4 "4" (Canceled) if the order was already cancelled
102 CxlRejReason 1 "0": order already cancelled, "1": unknown order
434 CxlRejResponseTo 1 Always set to "1"

Mass Order Cancel Request (q)

Sent by the server in response to a Mass Order Cancel Request (q)

Tag Name Value Description
35 MsgType q
530 MassCancelRequestType 7 7 for cancelling all orders on all markets, 1 for cancelling all orders on a specific market
11 ClOrdID order123 optional; client-assigned ID for mass order cancellation request
55 Symbol BTC-PERP optional; symbol name. This field is is required if MassCancelRequestType is set to 1, and ignored otherwise

A Mass Order Cancel Report (r) will be returned to the client.

Mass Order Cancel Report (r)

Sent by the server in response to a Mass Order Cancel Request (q)

Tag Name Value Description
35 MsgType r
530 MassCancelRequestType 7 the MassCancelRequestType of the corresponding Mass Order Cancel Request
11 ClOrdID order123 optional; the ClOrdID of the corresponding Mass Order Cancel Request. Omitted if no ClOrdID was supplied.
531 MassCancelResponse 0 if the request was rejected, otherwise set to the MassCancelRequestType of the corresponding Mass Order Cancel Request
532 MssCancelRejectReason optional; 0 if the market specified in the Mass Order Cancel Request was unknown

Order Status Request (H)

Sent by the client to request the status of an order.

Tag Name Value Description
35 MsgType H
37 OrderID 123456 OrderID of the order to request, or "*" to request all pending orders
41 OrigClOrdID order123 Client-assigned order ID of the order
20000 IncludeFillInfo N If Y, server will include fill info

The server will respond with an ExecutionReport (8) with ExecType=I (OrderStatus) with the requested order or orders. Only one of OrderID (37) and OrigClOrdID (41) should be provided. When there are no open orders, the server will include Text (58) of "No open orders".

Additional fields included with IncludeFillInfo (20000=Y):

Tag Name Value Description
1362 NoFills 1 Number of fills for this order

The following fields are included zero or more times, once for each fill:

Tag Name Value Description
1363 FillExecID 23436 Fill ID
1364 FillPx 10.1 Fill price
1365 FillQty 6.32 Fill quantity
1366 FillTradeID 101293 Fill trade ID. This will be shared by the fill corresponding to the other side of the trade.
1367 FillTime 20200219-08:33:26.513 Fill time
1443 FillLiquidityInd 2 1 for maker, 2 for taker
20100 FeeRate 0.0007 Fees paid on the fill, in percent
20101 Fee 0.0446824 Fees paid on the fill, in USD

Execution Report (8)

Sent by the server whenever an order receives a fill, whenever the status of an order changes, or in response to a NewOrderSingle (D), OrderCancelRequest (F), or OrderStatusRequest (H) message from the client.

Tag Name Value Description
35 MsgType 8
11 ClOrdID order123 Client-selected order ID.
37 OrderID 123456 Server-assigned order ID
17 ExecID d840c87b-ad98-47b1-95d3-4d41950fa776 unique execution ID. Equal to Fill ID if this message was the result of a fill
55 Symbol BTC-PERP Symbol name
54 Side 1 "1": buy; "2": sell
38 OrderQty 1.2 Original order quantity
44 Price 8000 Original order price
150 ExecType 1 Reason for this message (see below)
39 OrdStatus 0 Order status (see below)
14 CumQty 0.4 Quantity of order that has already been filled
151 LeavesQty 0.8 Quantity of order that is still open
84 CxlQty 0.0 Quantity cancelled by self-trade prevention. Only present if the cancelled quantity is greater than zero
60 TransactTime 20190525-08:26:38.989 Time of the order update. Only present on order updates
31 LastPx 7999.25 Fill price. Only present if this message was the result of a fill
32 LastQty 0.4 Fill quantity. Only present if this message was the result of a fill
1057 AggressorIndicator Y "Y": taker fill; "N": maker fill. Only present if this message was the result of a fill
1366 FillTradeID 101293 Fill trade ID. Only present if this message was the result of a fill
12 Commission 0.0067307233000000 Fee for trade in USD. Only present if this message was the result of a fill
13 CommType 3 Always 3 (absolute)
103 OrdRejReason 3 Reason the order was rejected (see below). Only present on rejected NewOrderSingle (D) requests
58 Text 58 Description of the reason the order was rejected (e.g., Too many requests). Only present on rejected NewOrderSingle (D) requests
5000 Liquidation 58 "Y": messages corresponds to an on-market liquidation order. "N" or absent: it does not.

ExecType values

The ExecType (150) field indicates the reason why this ExecutionReport was sent.

ExecType Description
0 New order
1 New fill for order
3 Order done (fully filled)
4 Order cancelled
5 Order resized (possible for reduce-only orders)
A Response to a successful NewOrderSingle (D) request
8 Response to a rejected NewOrderSingle (D) request
6 Response to a successful OrderCancelRequest (F) request
I Response to a OrderStatusRequest (H) request

Note that every fill will generate a new ExecType=1 message. If a fill causes an order to be fully filled, both a ExecType=1 message and a ExecType=3 message will be generated. Similarly, a newly placed order that is immediately matched against an opposing order will generate both a ExecType=0 message and a ExecType=1 message.

OrdStatus values

OrdStatus Description
0 New order
1 Partially filled order
3 Fully filled order
4 Cancelled order
5 Resized order
6 Pending cancel

OrdRejReason values

OrdRejReason Description
3 Risk limits exceeded
99 Too many requests
0 Other errors

Reject (3)

Sent by the server in response to an invalid message.

Tag Name Value Description
35 MsgType 3
45 RefSeqNum 2 Sequence number of the rejected message
371 RefTagID 38 Tag number of the rejected field
372 RefMsgType D Message type of the rejected message
58 Text Missing quantity Human-readable description of the reason for the rejection
373 SessionRejectReason 1 Code to identify the rejection reason (see below)

Rejection reason codes

SessionRejectReason Description
1 Required tag missing
5 Value incorrect for this tag
6 Incorrect data format for value
11 Invalid MsgType
python javascript csharp