List Clearing Trades

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

Retrieve settled and in-flight clearing trades for the account.

POSTv1/clearing/trades

curl --request POST \
  --url https://api.gemini.com/v1/clearing/trades \
  --header 'Content-Type: application/json' \
  --header 'X-GEMINI-APIKEY: <string>' \
  --header 'X-GEMINI-PAYLOAD: <string>' \
  --header 'X-GEMINI-SIGNATURE: <string>' \
  --data '
{
  "request": "/v1/clearing/trades",
  "nonce": "<nonce>",
  "timestamp_nanos": 1630382206000000000,
  "limit_per_account": 50
}
'

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/trades"

nonceTimestampType | integer·required

timestampExample: 1495127793000

timestamp_nanosinteger

Only return transfers on or after this timestamp in nanos

limit_per_accountinteger

The maximum number of clearing trades to return. The default is 100 and the maximum is 300.

accountstring

Only required when using a master api-key. The name of the account within the subaccount group.

symbolstring

The trading pair

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

limit_tradesinteger

The maximum number of trades to return

Responses

Successful operation

resultsarray

results[].sourceAccountstring

A account that corresponds with the counterparty sourcing the clearing trade

results[].targetAccountstring

A account that corresponds with the counterparty where the clearing trade is targeted

results[].pairstring

The trading pair of the clearing trade

results[].sourceSidestring·enum

"buy" or "sell"Enum values: buysell

results[].pricestring

The price the clearing order was executed at

results[].quantitystring

The amount that was executed

results[].clearingIdstring

The clearing ID

results[].statusstring

A description of the status of the order

results[].expirationTimeMsstring | 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

results[].createdMsstring | 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

results[].lastUpdatedMsstring | 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

results[].hasBrokerboolean

Broker trade

results[].wasNotifiedboolean

Broker was notified

PreviousCreate New Broker Order NextInstant Orders

Last modified on May 5, 2026

curl --request POST \ --url https://api.gemini.com/v1/clearing/trades \ --header 'Content-Type: application/json' \ --header 'X-GEMINI-APIKEY: <string>' \ --header 'X-GEMINI-PAYLOAD: <string>' \ --header 'X-GEMINI-SIGNATURE: <string>' \ --data ' { "request": "/v1/clearing/trades", "nonce": "<nonce>", "timestamp_nanos": 1630382206000000000, "limit_per_account": 50 } '

Request Body

requeststring·required

The literal string "/v1/clearing/trades"

nonceTimestampType | integer·required

timestampExample: 1495127793000

timestamp_nanosinteger

Only return transfers on or after this timestamp in nanos

limit_per_accountinteger

The maximum number of clearing trades to return. The default is 100 and the maximum is 300.

accountstring

Only required when using a master api-key. The name of the account within the subaccount group.

symbolstring

The trading pair

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

limit_tradesinteger

The maximum number of trades to return

Responses

Successful operation

resultsarray

results[].sourceAccountstring

A account that corresponds with the counterparty sourcing the clearing trade

results[].targetAccountstring

A account that corresponds with the counterparty where the clearing trade is targeted

results[].pairstring

The trading pair of the clearing trade

results[].sourceSidestring·enum

"buy" or "sell"Enum values: buysell

results[].pricestring

The price the clearing order was executed at

results[].quantitystring

The amount that was executed

results[].clearingIdstring

The clearing ID

results[].statusstring

A description of the status of the order

results[].expirationTimeMsstring | 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

results[].createdMsstring | 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

results[].lastUpdatedMsstring | 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

results[].hasBrokerboolean

Broker trade

results[].wasNotifiedboolean

Broker was notified