Deribit Block Trade API is one of 19 APIs that Deribit publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Block Trade. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and rate-limit docs.
This API exposes
11 operations
across 11 paths,
and defines 30 schemas.
It is described by OpenAPI 3.0.0, at version 2.1.1.
Requests are made against a single base URL, https://test.deribit.com/api/v2.
11 operations11 paths30 schemas11 GET
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.0.0
API Version
2.1.1
Base URL
https://www.deribit.com/api/v2
Resource Areas
1
Paths & Operations 11
Across 11 paths, the API surfaces 11 operations — 11 GET. Each is listed below with its method, path, parameters, and response codes.
Block Trade 11
GET
/private/simulate_block_trade
Checks if a block trade can be executed without actually executing it. Use this method to verify that a block trade will succeed before proceeding with the actual execution. 📖 Related Article: [Block…
2 paramsbody→ 200
GET
/private/verify_block_trade
Verifies and creates a block trade signature. This is the first step in the block trade workflow - the first party calls this method to generate a signature that must be shared with the second party.…
4 paramsbody→ 200
GET
/private/execute_block_trade
Executes a block trade. This is the second step in the block trade workflow - the second party calls this method with the signature received from the first party to execute the trade. The whole reque…
5 paramsbody→ 200
GET
/private/invalidate_block_trade_signature
Invalidates a block trade signature, effectively cancelling the block trade. This can be called at any time before [private/executeblocktrade](https://docs.deribit.com/api-reference/block-trade/priva…
1 parambody→ 200
GET
/private/get_block_trade
Returns information about a specific block trade identified by blocktradeid. 📖 Related Article: [Block Trading](https://docs.deribit.com/articles/block-trading-api) Scope: blocktrade:read [Try in API…
1 parambody→ 200
GET
/private/get_block_trades
Returns a list of the user's block trades. If currency is not provided, returns block trades for all currencies. blockrfqid can be provided to receive block trades related to that particular Block RF…
6 paramsbody→ 200
GET
/private/get_block_trade_requests
Provides a list of block trade requests including pending approvals, declined trades, and expired trades. timestamp and nonce received in response can be used with [private/approveblocktrade](https:/…
1 parambody→ 200
GET
/private/approve_block_trade
Approves a pending block trade. nonce and timestamp are used to identify the block trade while role should be opposite to the trading counterparty. Use [private/getblocktraderequests](https://docs.de…
3 paramsbody→ 200
GET
/private/reject_block_trade
Rejects a pending block trade. nonce and timestamp are used to identify the block trade while role should be opposite to the trading counterparty. Use [private/getblocktraderequests](https://docs.der…
3 paramsbody→ 200
GET
/private/get_broker_trades
Broker Method Returns list of broker block trades. If currency is not provided, returns broker block trades for all currencies. Scope: blocktrade:read [Try in API console](https://test.deribit.com/ap…
4 paramsbody→ 200
GET
/private/get_broker_trade_requests
Broker Method Provides a list of broker block trade requests including pending approvals, declined trades, and expired trades. timestamp and nonce received in response can be used to approve or rejec…
body→ 200
Schemas 30
The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are user_trade (38 properties), pending_block_trade (12 properties), block_trade (6 properties), PrivateVerifyBlockTradeResponse (3 properties). Each schema is shown below with its type and property counts.
block_trade_id_in_result
string
Block trade id - when trade was part of a block trade
pending_block_trade
object
12 properties7 required
order_state_in_user_trade
string
Order state: "open", "filled", "rejected", "cancelled", "untriggered" or "archive" (if order was archived)
trade_id
string
Unique (per currency) trade identifier
PrivateGetBlockTradeRequestsResponse
object
3 properties2 required
timestamp
integer
The timestamp (milliseconds since the Unix epoch)
label_presentation
string
User defined label (presented only when previously set for order by user)
block_trade_id
string
Block trade id
tick_direction
integer
Direction of the "tick" (0 = Plus Tick, 1 = Zero-Plus Tick, 2 = Minus Tick, 3 = Zero-Minus Tick).
profit_loss
number
Profit and loss in base currency.
currency
string
Currency, i.e "BTC", "ETH", "USDC"
OkResponse
object
3 properties2 required
amount
number
It represents the requested order size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base…
PrivateGetBrokerTradesResponse
object
3 properties2 required
user_id
integer
Unique user identifier
direction
string
Direction: buy, or sell
trade_timestamp
integer
The timestamp of the trade (milliseconds since the UNIX epoch)
PrivateVerifyBlockTradeResponse
object
3 properties2 required
PrivateGetBlockTradesResponse
object
3 properties2 required
block_trade
object
6 properties3 required
nonce
string
Nonce
PrivateGetBrokerTradeRequestsResponse
object
3 properties2 required
block_trade_signature
string
Signature of block trade It is valid only for 5 minutes around given timestamp
price
number
Price in base currency
role
string
Trade role of the user: maker or taker
instrument_name
string
Unique instrument identifier
PrivateSimulateBlockTradeResponse
object
3 properties2 required
PrivateGetBlockTradeResponse
object
3 properties2 required
user_trade
object
38 properties15 required
trade_seq
integer
The sequence number of the trade within instrument
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Deribit Block Trade API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
