v2

OpenAPI 3.0.02026-07-311824171.4 MB
Block Trade
Private

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/get_block_trade_requests to retrieve pending block trades that require approval.

To use the block trade approval feature, an additional API key setting feature called enabled_features: block_trade_approval is required. This key has to be given to the broker/registered partner who performs the trades on behalf of the user for the feature to be active. If the user wants to approve the trade, they must approve it from a different API key that doesn't have this feature enabled.

📖 Related Article: Block Trading

Scope: block_trade:read_write

Try in API console

get/private/reject_block_trade

Query parameters

timestampinteger required

The timestamp (milliseconds since the Unix epoch)

Example:1536569522277

Timestamp, shared with other party (milliseconds since the UNIX epoch)

noncestring required

Nonce

Example:bF1_gfgcsd

Nonce, shared with other party

role'maker' | 'taker' required

Trade role of the user: maker or taker

Describes if user wants to be maker or taker of trades

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

result'ok' required

Result of method execution. ok in case of success