getTokenAccountsByDelegate Solana RPC Method

POST

getTokenAccountsByDelegate

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getTokenAccountsByDelegate",
  "params": [
    "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T",
    {
      "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
    },
    {
      "encoding": "jsonParsed"
    }
  ]
}
'

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "context": {
      "slot": 1114
    },
    "value": [
      {
        "pubkey": "28YTZEwqtMHWrhWcvv34se7pjS7wctgqzCPB3gReCFKp",
        "account": {
          "lamports": 1726080,
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "data": {
            "program": "spl-token",
            "parsed": {
              "info": {
                "tokenAmount": {
                  "amount": "1",
                  "decimals": 1,
                  "uiAmount": 0.1,
                  "uiAmountString": "0.1"
                },
                "delegate": "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T",
                "delegatedAmount": {
                  "amount": "1",
                  "decimals": 1,
                  "uiAmount": 0.1,
                  "uiAmountString": "0.1"
                }
              },
              "state": "initialized",
              "isNative": false,
              "mint": "3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E",
              "owner": "CnPoSPKXu7wJqxe59Fs72tkBeALovhsCxYeFwPCQH9TD"
            },
            "space": 165
          },
          "executable": false,
          "rentEpoch": 4,
          "space": 165
        }
      }
    ]
  }
}

Authorizations

api-key

string

query

required

Your Helius API key. You can get one for free in the dashboard.

Body

application/json

jsonrpc

enum<string>

default:2.0

The JSON-RPC protocol version.

Available options:

2.0

Example:

"2.0"

string

default:1

A unique identifier for the request.

Example:

"1"

method

enum<string>

default:getTokenAccountsByDelegate

The name of the RPC method to invoke.

Available options:

getTokenAccountsByDelegate

Example:

"getTokenAccountsByDelegate"

params

string · object · object[]

Parameters for querying token accounts by delegate.

Solana address (public key) of the delegate that has been authorized to manage token accounts.

Example:

"4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T"

Response

Successfully retrieved token accounts by delegate.

jsonrpc

enum<string>

The JSON-RPC protocol version.

Available options:

2.0

Example:

"2.0"

string

Identifier matching the request.

Example:

"1"

result

object

Context and account details.

Show child attributes

result.context

object

Context of the response.

Show child attributes

result.context.slot

integer

Slot in which the data was fetched.

Example:

1114

result.value

object[]

List of token accounts.

Show child attributes

result.value.pubkey

string

Account Pubkey as a base-58 encoded string.

Example:

"28YTZEwqtMHWrhWcvv34se7pjS7wctgqzCPB3gReCFKp"

result.value.account

object

Token account details.

Show child attributes

result.value.account.lamports

integer

Number of lamports assigned to the account.

Example:

1726080

result.value.account.owner

string

Pubkey of the program this account has been assigned to.

Example:

"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"

result.value.account.data

object

Token state data associated with the account.

Show child attributes

result.value.account.data.program

string

Program name.

Example:

"spl-token"

result.value.account.data.parsed

object

Parsed token data.

Show child attributes

result.value.account.data.parsed.info

object

Token account information.

Show child attributes

result.value.account.data.parsed.info.tokenAmount

object

Token amount details.

Show child attributes

result.value.account.data.parsed.info.tokenAmount.amount

string

Raw balance without decimals.

Example:

"1"

result.value.account.data.parsed.info.tokenAmount.decimals

integer

Number of decimals.

Example:

1

result.value.account.data.parsed.info.tokenAmount.uiAmount

number

Balance in user-friendly format.

Example:

0.1

result.value.account.data.parsed.info.tokenAmount.uiAmountString

string

Balance as a string.

Example:

"0.1"

result.value.account.data.parsed.info.delegate

string

The Solana address that has been granted delegate authorization to spend or manage tokens.

Example:

"4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T"

result.value.account.data.parsed.info.delegatedAmount

object

The amount of tokens the delegate has been authorized to spend on behalf of the owner.

Show child attributes

result.value.account.data.parsed.info.delegatedAmount.amount

string

Raw balance without decimals.

Example:

"1"

result.value.account.data.parsed.info.delegatedAmount.decimals

integer

Number of decimals.

Example:

1

result.value.account.data.parsed.info.delegatedAmount.uiAmount

number

Balance in user-friendly format.

Example:

0.1

result.value.account.data.parsed.info.delegatedAmount.uiAmountString

string

Balance as a string.

Example:

"0.1"

result.value.account.data.parsed.state

string

Token account state.

Example:

"initialized"

result.value.account.data.parsed.isNative

boolean

Indicates if the account holds native SOL.

Example:

false

result.value.account.data.parsed.mint

string

Pubkey of the token mint.

Example:

"3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E"

result.value.account.data.parsed.owner

string

Pubkey of the account owner.

Example:

"CnPoSPKXu7wJqxe59Fs72tkBeALovhsCxYeFwPCQH9TD"

result.value.account.data.space

integer

Space allocated for the account.

Example:

165

result.value.account.executable

boolean

Indicates if the account contains a program.

Example:

false

result.value.account.rentEpoch

integer

Epoch at which the account will next owe rent.

Example:

4

result.value.account.space

integer

Data size of the account.

Example:

165

getTokenAccountsByOwnerReturns all SPL Token accounts by token owner.

⌘I

getTokenAccountsByDelegate

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getTokenAccountsByDelegate",
  "params": [
    "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T",
    {
      "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
    },
    {
      "encoding": "jsonParsed"
    }
  ]
}
'

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "context": {
      "slot": 1114
    },
    "value": [
      {
        "pubkey": "28YTZEwqtMHWrhWcvv34se7pjS7wctgqzCPB3gReCFKp",
        "account": {
          "lamports": 1726080,
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "data": {
            "program": "spl-token",
            "parsed": {
              "info": {
                "tokenAmount": {
                  "amount": "1",
                  "decimals": 1,
                  "uiAmount": 0.1,
                  "uiAmountString": "0.1"
                },
                "delegate": "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T",
                "delegatedAmount": {
                  "amount": "1",
                  "decimals": 1,
                  "uiAmount": 0.1,
                  "uiAmountString": "0.1"
                }
              },
              "state": "initialized",
              "isNative": false,
              "mint": "3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E",
              "owner": "CnPoSPKXu7wJqxe59Fs72tkBeALovhsCxYeFwPCQH9TD"
            },
            "space": 165
          },
          "executable": false,
          "rentEpoch": 4,
          "space": 165
        }
      }
    ]
  }
}

API Reference

Solana RPC APIs

Solana APIs

Data Streaming APIs

Event Listening APIs

Deprecated APIs

getTokenAccountsByDelegate

Authorizations

Body

Response