GeminiGemini
SandboxGet API key
  • Crypto Trading
  • Prediction Markets
Changelog
Gemini Crypto Exchange LogoGemini Crypto Exchange Logo

© 2026 Gemini Space Station, Inc.

REST APIs
    Orders
    Market Data
    Derivatives
    Margin Trading
    Staking
    Clearing
      Create New Clearing OrderGet Clearing OrderCancel Clearing OrderConfirm Clearing OrderList Clearing OrdersList Clearing BrokersCreate New Broker OrderList Clearing Trades
    Instant Orders
    Fund Management
WebSocket
    AuthenticationMessage Format
    Streams
      Book TickerL2 Partial DepthL2 Differential DepthTrade StreamOrder EventsBalance Updates
    Playground
      Overviewconninfopingtimesubscribeunsubscribelist_subscriptionsdepthorder.placeorder.cancelorder.cancel_allorder.cancel_session
Agentic
FIX

Get Clearing Order

TradingClearingGet Clearing Order

Get Clearing Order

POSThttps://api.gemini.com/v1/clearing/status

Retrieve the current status of a bilateral clearing order.

POSTv1/clearing/status
curl --request POST \
  --url https://api.gemini.com/v1/clearing/status \
  --header 'Content-Type: application/json' \
  --header 'X-GEMINI-APIKEY: <string>' \
  --header 'X-GEMINI-PAYLOAD: <string>' \
  --header 'X-GEMINI-SIGNATURE: <string>' \
  --data '
{
  "request": "/v1/clearing/status",
  "nonce": "<nonce>",
  "clearing_id": "OM9VNL1G"
}
'

Roles

The API key you use to access this endpoint must have the Trader role assigned. See Roles for more information.

The OAuth scope must have clearing:read assigned to access this endpoint. See OAuth Scopes for more information.

Headers

X-GEMINI-APIKEYstring·required
Your API key
X-GEMINI-SIGNATUREstring·required
HEX-encoded HMAC-SHA384 of payload signed with API secret
X-GEMINI-PAYLOADstring·required
Base64-encoded JSON payload
Content-Typestring
Default: text/plain
Content-Lengthstring
Default: 0
Cache-Controlstring
Default: no-cache

Request Body

requeststring·required
The literal string "/v1/clearing/status"
nonceTimestampType | integer·required
timestampExample: 1495127793000
clearing_idstring·required
The clearing ID
accountstring
Required for Master API keys. The name of the account within the subaccount group.
Example request body
{
  "request": "/v1/clearing/status",
  "nonce": "<nonce>",
  "clearing_id": "OM9VNL1G"
}

Responses

Successful operation

clearing_idstring
The clearing ID
symbolstring
The trading pair
pricestring
The order price
amountstring
The order amount
sidestring·enum
Enum values: buysell
statusstring
The order status
timestampstring | integer
Gemini strongly recommends using milliseconds instead of seconds for timestamps.
Timestamp format
Example
Supported request type
string (seconds)
1495127793
POST only
string (milliseconds)
1495127793000
POST only
whole number (seconds)
1495127793
GET, POST
whole number (milliseconds)
1495127793000
GET, POST
Example: 1495127793000
timestampmsinteger
The timestamp in milliseconds
is_confirmedboolean
Whether the order is confirmed
Example Responses
{
  "result": "ok",
  "status": "Confirmed"
}
PreviousCreate New Clearing OrderNextCancel Clearing Order
Last modified on May 5, 2026