跳转到主要内容
GET
/
v1
/
wallet
/
{wallet}
/
history
获取交易历史
curl --request GET \
  --url 'https://api.helius.xyz/v1/wallet/{wallet}/history?api-key='
{
  "data": [
    {
      "signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
      "slot": 250000000,
      "fee": 0.000005,
      "feePayer": "GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz",
      "balanceChanges": [
        {
          "mint": "So11111111111111111111111111111111111111112",
          "amount": -0.05,
          "decimals": 9
        }
      ],
      "timestamp": 1704067200,
      "error": null
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
  }
}

​
请求参数

​
wallet
string
必填
Solana钱包地址（base58编码）
​
limit
number
默认值:"100"
每次请求的最大交易数量
​
before
string
获取此签名之前的交易（使用上一响应中的pagination.nextCursor）
​
after
string
获取此签名之后的交易（用于升序分页）
​
type
string
按交易类型过滤。可用类型：SWAP, TRANSFER, NFT_SALE, NFT_BID, NFT_LISTING, NFT_MINT, NFT_CANCEL_LISTING, TOKEN_MINT, BURN, COMPRESSED_NFT_MINT, COMPRESSED_NFT_TRANSFER, COMPRESSED_NFT_BURN, CREATE_STORE, WHITELIST_CREATOR, ADD_TO_WHITELIST, REMOVE_FROM_WHITELIST, AUCTION_MANAGER_CLAIM_BID, EMPTY_PAYMENT_ACCOUNT, UPDATE_PRIMARY_SALE_METADATA, ADD_TOKEN_TO_VAULT, ACTIVATE_VAULT, INIT_VAULT, INIT_BANK, INIT_STAKE, MERGE_STAKE, SPLIT_STAKE, CREATE_AUCTION_MANAGER, START_AUCTION, CREATE_AUCTION_MANAGER_V2, UPDATE_EXTERNAL_PRICE_ACCOUNT, EXECUTE_TRANSACTION
  • SWAP
  • TRANSFER
  • NFT_SALE
  • NFT_BID
  • NFT_LISTING
  • NFT_MINT
  • NFT_CANCEL_LISTING
  • TOKEN_MINT
  • BURN
  • COMPRESSED_NFT_MINT
  • COMPRESSED_NFT_TRANSFER
  • COMPRESSED_NFT_BURN
  • CREATE_STORE
  • WHITELIST_CREATOR
  • ADD_TO_WHITELIST
  • REMOVE_FROM_WHITELIST
  • AUCTION_MANAGER_CLAIM_BID
  • EMPTY_PAYMENT_ACCOUNT
  • UPDATE_PRIMARY_SALE_METADATA
  • ADD_TOKEN_TO_VAULT
  • ACTIVATE_VAULT
  • INIT_VAULT
  • INIT_BANK
  • INIT_STAKE
  • MERGE_STAKE
  • SPLIT_STAKE
  • CREATE_AUCTION_MANAGER
  • START_AUCTION
  • CREATE_AUCTION_MANAGER_V2
  • UPDATE_EXTERNAL_PRICE_ACCOUNT
  • EXECUTE_TRANSACTION
​
tokenAccounts
string
默认值:"balanceChanged"
过滤涉及钱包拥有的代币账户的交易。
  • balanceChanged（推荐）：包括更改代币余额的交易，过滤垃圾信息
  • none：仅直接引用钱包的交易
  • all：所有涉及代币账户的交易（可能包含垃圾信息）
    • none
    • balanceChanged
    • all

授权

​
api-key
string
query
必填

作为查询参数传递的API密钥

路径参数

​
wallet
string
必填

Solana 钱包地址（base58 编码）

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

查询参数

​
limit
integer
默认值:100

每个请求的最大交易数量

必填范围: 1 <= x <= 100
​
before
string

获取此签名之前的交易（使用之前响应的pagination.nextCursor）

​
after
string

获取此签名之后的交易（用于升序分页）

​
type
enum<string>

按交易类型过滤。可用类型：SWAP, TRANSFER, NFT_SALE, NFT_BID, NFT_LISTING, NFT_MINT, NFT_CANCEL_LISTING, TOKEN_MINT, BURN, COMPRESSED_NFT_MINT, COMPRESSED_NFT_TRANSFER, COMPRESSED_NFT_BURN, CREATE_STORE, WHITELIST_CREATOR, ADD_TO_WHITELIST, REMOVE_FROM_WHITELIST, AUCTION_MANAGER_CLAIM_BID, EMPTY_PAYMENT_ACCOUNT, UPDATE_PRIMARY_SALE_METADATA, ADD_TOKEN_TO_VAULT, ACTIVATE_VAULT, INIT_VAULT, INIT_BANK, INIT_STAKE, MERGE_STAKE, SPLIT_STAKE, CREATE_AUCTION_MANAGER, START_AUCTION, CREATE_AUCTION_MANAGER_V2, UPDATE_EXTERNAL_PRICE_ACCOUNT, EXECUTE_TRANSACTION

可用选项:
SWAP,
TRANSFER,
NFT_SALE,
NFT_BID,
NFT_LISTING,
NFT_MINT,
取消NFT列表,
代币发行,
销毁,
压缩NFT铸造,
压缩NFT转移,
压缩NFT销毁,
创建商店,
白名单创建者,
添加至白名单,
从白名单移除,
拍卖经理认领出价,
清空付款账户,
更新主要销售元数据,
添加代币到保险库,
激活保险库,
初始化保险库,
初始化银行,
初始化抵押,
合并抵押,
拆分抵押,
创建拍卖经理,
开始拍卖,
创建拍卖经理V2,
更新外部价格账户,
执行交易
​
tokenAccounts
enum<string>
默认值:balanceChanged

过滤涉及钱包拥有的代币账户的交易。

  • balanceChanged（推荐）：包含更改代币余额的交易，过滤垃圾信息
  • none：仅直接引用钱包的交易
  • all：包括代币账户的所有交易（可能包含垃圾信息）
可用选项:
none,
balanceChanged,
all

响应

交易历史检索成功

​
data
object[]
必填
​
pagination
object
必填