List Approved Addresses

Trading Fund ManagementList Approved Addresses

List Approved Addresses

POSThttps://api.gemini.com/v1/approvedAddresses/account/{network}

Returns the Approved Address list for the specified network, including both account-level and group-level addresses.

POSTv1/approvedAddresses/account/ethereum

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

Roles

This endpoint can be accessed with any 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

Path Parameters

networkstring·required

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

Request Body

requeststring·required

The literal string "/v1/approvedAddresses/account/:network" where `:network` can be `bitcoin`, `ethereum`, `bitcoincash`, `litecoin`, `zcash`, `filecoin`, `dogecoin`, `tezos`, `solana`, `polkadot`, `avalanche`, `cosmos`, or `xrpl`

nonceTimestampType | integer·required

timestampExample: 1495127793000

accountstring

Required for Master API keys as described in [Private API Invocation](/authentication/api-key#private-api-invocation). The name of the account within the subaccount group. Specifies the account on which you intend to view the approved address list.

Responses

Successful operation

approvedAddressesarray

Array of approved addresses on both the account and group level.

approvedAddresses[].networkstring

The network of the approved address. Network can be `bitcoin`, `ethereum`, `bitcoincash`, `litecoin`, `zcash`, `filecoin`, `dogecoin`, `tezos`, `solana`, `polkadot`, `avalanche`, `cosmos`, or `xrpl`

approvedAddresses[].scopestring

Will return the scope of the address as either "account" or "group"

approvedAddresses[].labelstring

The label assigned to the address

approvedAddresses[].statusstring

The status of the address that will return as "active", "pending-time" or "pending-mua". The remaining time is exactly 7 days after the initial request. "pending-mua" is for multi-user accounts and will require another administator or fund manager on the account to approve the address.

approvedAddresses[].createdAtstring

UTC timestamp in millisecond of when the address was created.

approvedAddresses[].addressstring

The address on the approved address list.

PreviousList Payment Methods NextCreate New Approved Address

Last modified on May 5, 2026

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