Staking

List Staking Event History

This will show all staking deposits, redemptions and interest accruals.

Roles

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

How to iterate through all transactions:

To retrieve your full Staking history walking backwards,

  1. Initial request: POST to https://api.gemini.com/v1/staking/history with a JSON payload including sortAsc set to false and a limit key with value 500.
  2. When you receive the list of Staking transactions, they will be sorted by datetime descending - so the last element in the list will have the lowest timestamp value. For this example, say that value is X.
  3. Create a second POST request with a JSON payload including a until timestamp key with value X-1, sortAsc set to false, and a limit key with value 500.
  4. Take the last element of the list returned with lowest datetime value Y and create a third POST request with a JSON payload including a until timestamp key with value Y-1, sortAsc set to false, and a limit key with value 500.
  5. Continue creating POST requests and retrieving Staking transactions until an empty list is returned.
post/v1/staking/history

Request

  • Base URL
    https://api.gemini.com
  • URL
    https://api.gemini.com/v1/staking/history
  • Auth
    API key in header X-GEMINI-APIKEY and API key in header X-GEMINI-SIGNATURE and API key in header X-GEMINI-PAYLOAD

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
Content-Lengthstring
Cache-Controlstring

Request body

requeststring required

The literal string "/v1/staking/history"

accountstring

Required for Master API keys as described in Private API Invocation. The name of the account within the subaccount group.

limitinteger

The maximum number of transactions to return. Default is 50, max is 500.

providerIdstring

Borrower Id, in uuid4 format. providerId is accessible from the Staking rates response

currencystring

Currency code, see symbols

interestOnlyboolean

Toggles whether to only return daily interest transactions. Defaults to false.

sortAscboolean

Toggles whether to sort the transactions in ascending order by datetime. Defaults to false.

Example request

{
  "nonce": "1495127793000",
  "since": "1495127793000",
  "until": "1495127793000"
}

Response

Staking transaction history

providerIdstring

Provider Id, in uuid4 format

Example response

[
  {
    "providerId": "62b21e17-2534-4b9f-afcf-b7edb609dd8d",
    "transactions": [
      {
        "transactionId": "MPZ7LDD8",
        "transactionType": "Redeem",
        "amountCurrency": "MATIC",
        "amount": 20,
        "priceCurrency": "USD",
        "priceAmount": 0.1,
        "dateTime": "1495127793000"
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.