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

© 2026 Gemini Space Station, Inc.

Getting Started
Market Makers
    Maker Rebate ProgramLiquidity Rewards Program
WebSocket
    IntroductionAuthenticationMessage Format
    Streams
      Book TickerL2 Partial DepthL2 Differential DepthTrade StreamOrder EventsBalance UpdatesPosition UpdatesContract Status
    Playground
      OverviewconninfopingtimeSUBSCRIBEUNSUBSCRIBELIST_SUBSCRIPTIONSdepthorder.placeorder.cancelorder.cancel_allorder.cancel_session
REST APIs
    Combos
    Events
    Terms
    Order Management
    Positions
    Rewards
      Get Maker Rebate RatesList Maker Rebate PayoutsGet Maker Rebate Lifetime SummaryGet Liquidity Rewards ConfigList Liquidity Rewards EventsGet Liquidity Rewards Daily SummaryGet Liquidity Rewards Lifetime Summary
Combo Contracts
    Overview
Tickers
    OverviewCryptoSportsCommoditiesWeather
Schemas

Get Liquidity Rewards Lifetime Summary

REST APIsPrediction MarketsRewardsGet Liquidity Rewards Lifetime Summary

Get Liquidity Rewards Lifetime Summary

GEThttps://api.gemini.com/v1/prediction-markets/liquidity-rewards/summary/total

Returns lifetime totals for the authenticated account's Liquidity Rewards payouts. Provide both dateFrom and dateTo to restrict to a date window, or omit both for all-time totals.

GETv1/prediction-markets/liquidity-rewards/summary/total
curl --request GET \
  --url https://api.gemini.com/v1/prediction-markets/liquidity-rewards/summary/total \
  --header 'X-GEMINI-APIKEY: <string>' \
  --header 'X-GEMINI-PAYLOAD: <string>' \
  --header 'X-GEMINI-SIGNATURE: <string>'

Roles

The API key you use to access this endpoint must have the Trader role assigned. See Roles 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

Query Parameters

dateFromstring
Inclusive start of the payout date window (YYYY-MM-DD, Eastern Time). Must be provided together with dateTo.
dateTostring
Inclusive end of the payout date window (YYYY-MM-DD, Eastern Time). Must be on or after dateFrom and within 5 years of it.

Responses

Successful response

total_earned_usdstring·required
Sum of `total_reward_usd` across daily payouts in the window.Example: 84.20
payout_countinteger (int32)·required
Number of daily payouts in the window. Always present; `0` when no payouts exist in the window.Example: 12
first_payout_datestring (date)·required
Date of the earliest payout in the window, or `null` if no payouts exist.Example: 2026-05-08
last_payout_datestring (date)·required
Date of the most recent payout in the window, or `null` if no payouts exist.Example: 2026-05-20
Example Responses
{
  "total_earned_usd": "84.20",
  "payout_count": 12,
  "first_payout_date": "2026-05-08",
  "last_payout_date": "2026-05-20"
}
PreviousGet Liquidity Rewards Daily SummaryNextRewards
Last modified on May 23, 2026