GEgemini
Fund Management

Create New Deposit Address

<div class="p-4 text-sm section-icon section-info rounded-sm" role="alert"> <div class="flex"> <svg view-box="0 0 24 24" > <path fill-rule="evenodd" clip-rule="evenodd" d="M4 12C4 7.58172 7.58172 4 12 4C16.4183 4 20 7.58172 20 12C20 16.4183 16.4183 20 12 20C7.58172 20 4 16.4183 4 12ZM12 2C6.47715 2 2 6.47715 2 12C2 17.5228 6.47715 22 12 22C17.5228 22 22 17.5228 22 12C22 6.47715 17.5228 2 12 2ZM11 17V11H13V17H11ZM11 9V7H13V9H11Z" /> </svg> <div>Under the terms of the <a href="https://www.gemini.com/legal/api-agreement">Gemini API Agreement</a>, polling this endpoint may be subject to <a href="/rate-limit">rate limiting</a>. This endpoint is currently restricted further than our standard rate limiting to a rate of 1 request per 2 seconds per subaccount. This rate is subject to change and will be updated here accordingly.</div> </div> </div>

Roles

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

The OAuth scope must have addresses:create assigned to access this endpoint. See OAuth Scopes for more information.

post/v1/deposit/{network}/newAddress

Request

  • Base URL
    https://api.gemini.com
  • URL
    https://api.gemini.com/v1/deposit/{network}/newAddress
  • Auth
    API key in header X-GEMINI-APIKEY and API key in header X-GEMINI-SIGNATURE and API key in header X-GEMINI-PAYLOAD

Path parameters

networkstring required

Can be bitcoin, ethereum, bitcoincash, litecoin, zcash, filecoin, dogecoin, tezos, solana, polkadot, avalanche, cosmos, or xrpl

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/deposit/network/newAddress"

labelstring

A label for the address

legacyboolean

Whether to generate a legacy P2SH-P2PKH litecoin address. False by default.

accountstring

Required for Master API keys. The name of the account within the subaccount group.

Example request

{
  "nonce": "1495127793000"
}

Response

Successful operation

addressstring

String representation of the cryptocurrency address

labelstring

If you provided a label when creating the address, it will be echoed back here

memostring

It would be present if applicable, it will be present for cosmos address

networkstring

The blockchain network for the address

Example response

{
  "timestamp": "1495127793000"
}

Changes

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