跳转到主要内容
POST
getProgramAccounts
curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getProgramAccounts",
  "params": [
    "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T"
  ]
}
'
{
  "jsonrpc": "2.0",
  "id": "1",
  "result": [
    {
      "pubkey": "CxELquR1gPP8wHe33gZ4QxqGB3sZ9RSwsJ2KshVewkFY",
      "account": {
        "lamports": 15298080,
        "owner": "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T",
        "data": [
          "2R9jLfiAQ9bgdcw6h8s44439",
          "base58"
        ],
        "executable": false,
        "rentEpoch": 28,
        "space": 42
      }
    }
  ]
}
新功能: getProgramAccounts 现在支持参数 changedSinceSlot，用于增量更新。指定后，该方法仅返回在给定插槽号时或之后已修改的账户。这非常适合实时索引和数据同步工作流。

​
请求参数

​
address
string
必填
所查询账户的 Solana 程序公共密钥（地址），为 base-58 编码字符串。
​
commitment
string
请求的承诺等级。
  • confirmed
  • finalized
  • processed
​
minContextSlot
number
请求可以评估的最小插槽。
​
withContext
boolean
将结果包装在一个 RpcResponse JSON 对象中。
​
encoding
string
返回的账户数据的编码格式。
  • jsonParsed
  • base58
  • base64
  • base64+zstd
​
dataSlice
object
请求账户数据的一个切片。
​
dataSlice.length
number
要返回的字节数。
​
dataSlice.offset
number
开始读取的字节偏移量。
​
changedSinceSlot
number
仅返回在此插槽号时或之后已修改的账户。适用于增量更新。
​
filters
array
强大的过滤系统，可以高效查询特定的 Solana 账户数据模式。

授权

​
api-key
string
query
必填

您的 Helius API 密钥。您可以在仪表板中免费获取一个。

请求体

application/json
​
jsonrpc
enum<string>
默认值:2.0
必填

JSON-RPC协议版本。

可用选项:
2.0
示例:

"2.0"

​
id
string
默认值:1
必填

请求的唯一标识符。

示例:

"1"

​
method
enum<string>
默认值:getProgramAccounts
必填

要调用的RPC方法名称。

可用选项:
getProgramAccounts
示例:

"getProgramAccounts"

​
params
(string | object)[]
必填

方法的参数。

要查询账户的Solana程序公钥（地址），以base-58编码的字符串表示。

示例:

"4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T"

响应

成功检索到程序账户。

​
jsonrpc
enum<string>

JSON-RPC协议版本。

可用选项:
2.0
示例:

"2.0"

​
id
string

与请求匹配的标识符。

示例:

"1"

​
result
object[]

程序账户列表。