Gemini Crypto Exchange Logo
REST API

​Instant (1.0.0)

Endpoint

​Get Instant Quote

POST
https://api.gemini.com
/v1/instant/quote

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 orders:create assigned to access this endpoint. See OAuth Scopes for more information.

​Get Instant Quote › 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

​Get Instant Quote › Request Body

  • requeststring · required

    The literal string "/v1/instant/quote/"

  • sidestring · enum · required

    "buy" or "sell"

    Enum values:
    buy
    sell
  • symbolstring · required

    The symbol for the order. Instant includes order books denominated in a supported currency, as CCY2

  • noncerequired

    The nonce, as described in Private API Invocation

  • totalSpendstring · required

    Quoted decimal amount to spend on the order. Must comply with stated minimums. The totalSpend will be CCY2 in buy orders and CCY1 in sell orders.

  • paymentMethodUuidstring

    uuid provided as bankId in Payment Methods API

  • paymentMethodTypestring

    Method used to specify payment method in buy order. Can be "AccountBalancePaymentType" to use funds available in USD balance held on Gemini, "BankAccountType" to initial an ACH from a linked bank account, or "CardAccountType" to use a linked debit card to fund the purchase.

  • accountstring

    Required for Master API keys as described in Private API Invocation. The name of the account within the subaccount group. Specifies the account on which you intend to place the order. Only available for exchange accounts.

​Get Instant Quote › Responses

    • quoteIdinteger

      Unique ID for the quote. This is used in the execution of the order

    • maxAgeMsinteger

      Number of milliseconds until this quote price expires. Once expired, you will need to request a new quote

    • pairstring

      The symbol passed in the quote request

    • pricestring

      The quoted price of the asset. This will not change when attempting execution

    • priceCurrencystring

      The currency in which the order is priced. Matches CCY2 in the symbol

    • sidestring · enum

      Either "buy" or "sell"

      Enum values:
      buy
      sell
    • quantitystring

      The quantity of the asset to be bought or sold

    • quantityCurrencystring

      The currency label for the quantity field. Matches CCY1 in the symbol

    • feestring

      The fee quantity to be taken for the order upon execution

    • feeCurrencystring

      The currency label for the order

    • depositFeestring

      The deposit fee quantity. Will be applied if a debit card is used for the order. Will return 0 if there is no depositFee

    • depositFeeCurrencystring

      Currency in which depositFee is taken

    • totalSpendstring

      Total quantity to spend for the order. Will be the sum inclusive of all fees and amount to be traded.

    • totalSpendCurrencystring

      Currency of the totalSpend to be spent on the order

​Execute Instant Order

POST
https://api.gemini.com
/v1/instant/execute

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 orders:create assigned to access this endpoint. See OAuth Scopes for more information.

​Execute Instant Order › 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

​Execute Instant Order › Request Body

  • requeststring · required

    The literal string "/v1/instant/execute"

  • noncerequired

    The nonce, as described in Private API Invocation

  • symbolstring · required

    The symbol for the order.

  • sidestring · enum · required

    "buy" or "sell"

    Enum values:
    buy
    sell
  • quantitystring · required

    The quantity of the asset bought or sold. quantity must match quantity returned in the quote

  • feestring · required

    The fee for the order. fee must match fee returned in the quote

  • quoteIdinteger · required

    Unique ID for the quote. quoteId must match quoteId returned in the quote

  • accountstring

    Required for Master API keys as described in Private API Invocation. The name of the account within the subaccount group. Specifies the account on which you intend to place the order. Only available for exchange accounts.

​Execute Instant Order › Responses

    • orderIdinteger

      The ID for the executed order

    • pairstring

      The symbol for the order.

    • pricestring

      The price at which the order was executed

    • priceCurrencystring

      The currency in which the order is priced. Matches CCY2 in the symbol

    • sidestring

      Either "buy" or "sell"

    • quantitystring

      The quantity of the asset bought or sold

    • quantityCurrencystring

      The currency label for the quantity field.

    • totalSpendstring

      Total quantity to spend for the order. Will be the sum inclusive of all fees and amount to be traded.

    • totalSpendCurrencystring

      Currency of the totalSpend to be spent on the order

    • feestring

      The fee quantity charged for the order

    • feeCurrencystring

      The currency label for the fee.

    • depositFeestring

      The deposit fee quantity. Will be applied if a debit card is used for the order. Will return 0 if there is no depositFee

    • depositFeeCurrencystring

      Currency in which depositFee is taken

ClearingAccount Administration