Skip to content
/Block Trade

Fig Markets REST API (1.0)

Below are the available REST API endpoints for Fig Markets REST API

Languages
Servers
Test API

https://api.test.figmarkets.com/v1/

Production API

https://api.figmarkets.com/v1/

Account

Account endpoints

Operations

Block Trade

Block trade endpoints

Operations

/block-trade/bulk

Request

Create multiple block trades via a single request.

For each block trade you need to supply the exchange credentials to use for the maker and taker side of the block trade. The credentials must be for the same exchange and should be allowed to block trade without any additional confirmations.

Each block trade must contain a unique nonce.

The direction of the instruments in each trade must be set to the direction expected by the maker.

Note that each block trade is executed independently, so if one fails, the others will still be executed.

Bodyapplication/jsonrequired

Bulk block trade creation request

timestampinteger(blockTrade.timestamp)required

Timestamp for the block trade (unix timestamp in milliseconds)

blockTradesArray of objects(request.BlockTrade)required

Array of block trades

noncestring(blockTrade.nonce)

A unique identifier for the block trade

makerExchangeCredentialsstring(blockTrade.makerExchangeCredentials)

The alias of the exchange credentials to use for the maker side of the block trade

takerExchangeCredentialsstring(blockTrade.takerExchangeCredentials)

The alias of the exchange credentials to use for the taker side of the block trade

tradesArray of objects(request.BlockTradeItem)

Array of instruments/prices/amounts to be included in the block trade

curl -i -X POST \
  https://api.test.figmarkets.com/v1/block-trade/bulk \
  -H 'Content-Type: application/json' \
  -d '{
    "timestamp": 1756802862567,
    "blockTrades": [
      {
        "nonce": "fe4a5ef4-5420-48e0-af31-08487d931d28",
        "makerExchangeCredentials": "DBT-main",
        "takerExchangeCredentials": "DBT-secondary",
        "trades": [
          {
            "direction": "buy",
            "instrumentName": "BTC-31DEC25-120000-C",
            "price": 0.025,
            "amount": 25
          }
        ]
      }
    ]
  }'

Responses

List of responses for each of the block trades in the request

Bodyapplication/jsonArray [
blockTradeIdinteger(blockTrade.blockTradeId)

The Fig Markets unique identifier for the block trade. Only returned if the block trade was executed successfully.

noncestring(blockTrade.nonce)

The nonce that was provided with the request for the specific block trade

exchangeResultobject

If the trade was executed successfully, this will be the response provided by the exchange where the block trade is executed

exchangeErrorobject

If the exchange returns an error it will be returned here. The format will be the same as the error response from the exchange

]
Response
application/json
[
  {
    "blockTradeId": 1234,
    "nonce": "fe4a5ef4-5420-48e0-af31-08487d931d28",
    "exchangeResult": {},
    "exchangeError": {}
  }
]

Exchange

Exchange endpoints

Operations

RFQs

RFQ endpoints

Operations
Copyright © Fig Markets Inc. All rights reserved.