Get Transaction History

Trading Fund ManagementGet Transaction History

Get Transaction History

POSThttps://api.gemini.com/v1/transactions

Returns trade details and transactions for the account. Supports pagination via a continuation token. Historical data is only available for dates after August 1st, 2022.

Note

Due to current limitations, historical data can only be returned for dates after August 1st, 2022. Use continuation_token for pagination — do not use it together with timestamp_nanos.

POSTv1/transactions

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

Roles

The API key you use to access this endpoint must have the Trader, Fund Manager, or Auditor role assigned, with master account scope. See Roles for more information.

The OAuth scope must have history: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/transactions"

nonceTimestampType | integer·required

timestampExample: 1495127793000

timestamp_nanosstring | 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

limitinteger

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

continuation_tokenstring

For subsequent requests, use the returned `continuation_token` value for next page. If this is defined, do not define “timestamp_nanos”.

Responses

The response will be an array of JSON objects, sorted by trade and transfer as well as a continuationToken to be used in subsequent requests.

resultsarray

Results will contain either a list of Trade or Transfer responses

PreviousTransfer Between Accounts

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

Request Body

requeststring·required

The literal string "/v1/transactions"

nonceTimestampType | integer·required

timestampExample: 1495127793000

timestamp_nanosstring | 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

limitinteger

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

continuation_tokenstring

For subsequent requests, use the returned `continuation_token` value for next page. If this is defined, do not define “timestamp_nanos”.

Responses

The response will be an array of JSON objects, sorted by trade and transfer as well as a continuationToken to be used in subsequent requests.

resultsarray

Results will contain either a list of Trade or Transfer responses