> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# getTransactionsForAddress
> getTransactionsForAddress trả về toàn bộ lịch sử giao dịch Solana của một địa chỉ trong một lệnh gọi — hỗ trợ bộ lọc theo thời gian, slot và trạng thái, cùng tính năng sắp xếp và phân trang theo khóa.
## Tham số yêu cầu
Địa chỉ tài khoản Solana cần truy xuất lịch sử giao dịch (ví, token, chương trình, NFT, v.v.).
Mức độ chi tiết của giao dịch cần trả về.
* `signatures`
* `full`
Thứ tự sắp xếp các giao dịch được trả về.
* `asc`
* `desc`
Mức cam kết cho yêu cầu. Không hỗ trợ mức cam kết `processed`.
* `confirmed`
* `finalized`
Slot ngữ cảnh tối thiểu dùng cho yêu cầu (không bắt buộc).
Số lượng giao dịch tối đa cho mỗi yêu cầu. Sử dụng 1–1000 cho transactionDetails:"signatures" và 1–1000 cho transactionDetails:"full".
Token phân trang từ phản hồi trước để lấy trang kết quả tiếp theo (định dạng "slot:position").
Định dạng mã hóa cho dữ liệu giao dịch (chỉ áp dụng khi transactionDetails=full).
* `json`
* `jsonParsed`
* `base58`
* `base64`
Phiên bản giao dịch tối đa cần trả về (chỉ áp dụng khi transactionDetails=full). Đặt thành 1 để nhận các giao dịch legacy, v0 và v1.
Các bộ lọc nâng cao để thu hẹp kết quả giao dịch.
Lọc theo số slot.
Lớn hơn hoặc bằng số slot.
Lớn hơn số slot.
Nhỏ hơn hoặc bằng số slot.
Nhỏ hơn số slot.
Lọc theo dấu thời gian của khối (dấu thời gian Unix).
Lớn hơn hoặc bằng dấu thời gian.
Lớn hơn dấu thời gian.
Nhỏ hơn hoặc bằng dấu thời gian.
Nhỏ hơn dấu thời gian.
Bằng dấu thời gian.
Lọc theo chữ ký giao dịch.
Lấy các giao dịch có chữ ký lớn hơn hoặc bằng giá trị này.
Lấy các giao dịch sau chữ ký này.
Lấy các giao dịch có chữ ký nhỏ hơn hoặc bằng giá trị này.
Lấy các giao dịch trước chữ ký này.
Lọc theo trạng thái giao dịch.
* `succeeded`
* `failed`
* `any`
Lọc giao dịch cho các tài khoản token liên quan. Kiểm soát việc có bao gồm các giao dịch liên quan đến tài khoản token do địa chỉ này sở hữu hay không.
* `none`
* `balanceChanged`
* `all`
Thu hẹp kết quả thành các giao dịch mà địa chỉ được truy vấn đã tham gia vào một lượt chuyển token khớp với các tiêu chí cụ thể. Tất cả các trường đều không bắt buộc và được kết hợp theo ngữ nghĩa AND.
Địa chỉ đối tác. Khớp với các lượt chuyển có phía còn lại là địa chỉ này.
Hướng chuyển so với địa chỉ được truy vấn.
* `in`
* `out`
* `any`
Mint token dùng để lọc.
Bộ lọc phạm vi số lượng thô trên chuỗi. Tất cả các trường đều không bắt buộc và có thể kết hợp với nhau.
## OpenAPI
````yaml vi/openapi/rpc-http/getTransactionsForAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API lịch sử giao dịch Solana nâng cao với các khả năng lọc, sắp xếp và phân
trang mạnh mẽ để truy xuất dữ liệu giao dịch toàn diện cho bất kỳ địa chỉ
nào.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Điểm cuối RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Điểm cuối RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getTransactionsForAddress
description: >
API lịch sử giao dịch nâng cao cung cấp các khả năng lọc, sắp xếp và
phân trang mạnh mẽ
để truy xuất dữ liệu giao dịch liên kết với bất kỳ địa chỉ Solana nào.
Phương thức nâng cao này khắc phục
các hạn chế của getSignaturesForAddress bằng cách cung cấp:
- Sắp xếp hai chiều (thứ tự thời gian tăng dần/giảm dần)
- Lọc nâng cao theo slot, thời gian, chữ ký và trạng thái giao dịch
- Hỗ trợ tài khoản token (bao gồm giao dịch cho các tài khoản token liên
kết)
- Lọc lần chuyển token theo đối tác, hướng, mint và số lượng thô
- Phân trang keyset hiệu quả bằng các khóa dựa trên slot
- Tùy chọn trả về đầy đủ chi tiết giao dịch hoặc chỉ chữ ký
- Hỗ trợ truy vấn theo khoảng thời gian và lọc trạng thái
Lý tưởng để xây dựng lịch sử ví toàn diện, bảng điều khiển phân tích,
nhật ký kiểm tra
và mọi ứng dụng cần phân tích giao dịch chi tiết với khả năng kiểm soát
chính xác việc truy xuất dữ liệu.
operationId: getTransactionsForAddress
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
example: '2.0'
description: Phiên bản giao thức JSON-RPC.
default: '2.0'
id:
type: string
example: '1'
description: Mã định danh duy nhất cho yêu cầu.
default: '1'
method:
type: string
enum:
- getTransactionsForAddress
example: getTransactionsForAddress
description: Tên của phương thức RPC cần gọi.
default: getTransactionsForAddress
params:
type: array
description: >-
Mảng chứa địa chỉ tài khoản bắt buộc và đối tượng cấu hình
không bắt buộc.
minItems: 1
maxItems: 2
default:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 50
sortOrder: desc
filters:
status: succeeded
slot:
gte: 1000
lt: 2000
tokenTransfer:
direction: in
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
items:
oneOf:
- type: string
description: >-
Địa chỉ tài khoản Solana cần truy xuất lịch sử giao
dịch (ví, token, chương trình, NFT, v.v.).
example: Vote111111111111111111111111111111111111111
- type: object
description: >-
Cấu hình truy vấn nâng cao để lọc, sắp xếp và phân
trang.
properties:
transactionDetails:
type: string
description: Mức độ chi tiết của giao dịch cần trả về.
enum:
- signatures
- full
default: signatures
example: signatures
sortOrder:
type: string
description: Thứ tự sắp xếp các giao dịch được trả về.
enum:
- asc
- desc
default: desc
example: desc
commitment:
type: string
description: >-
Mức cam kết cho yêu cầu. Mức cam kết `processed`
không được hỗ trợ.
enum:
- confirmed
- finalized
default: finalized
example: finalized
minContextSlot:
type: integer
description: >-
Slot ngữ cảnh tối thiểu cần dùng cho yêu cầu
(không bắt buộc).
example: 1000
limit:
type: integer
description: >-
Số lượng giao dịch tối đa cho mỗi yêu cầu. Sử dụng
1–1000 cho transactionDetails:"signatures" và
1–1000 cho transactionDetails:"full".
minimum: 1
maximum: 1000
default: 1000
example: 100
paginationToken:
type: string
description: >-
Token phân trang từ phản hồi trước để lấy trang
kết quả tiếp theo (định dạng "slot:position").
example: '1053:13'
encoding:
type: string
description: >-
Định dạng mã hóa cho dữ liệu giao dịch (chỉ áp
dụng khi transactionDetails=full).
enum:
- json
- jsonParsed
- base58
- base64
default: json
example: json
maxSupportedTransactionVersion:
type: integer
description: >-
Phiên bản giao dịch tối đa cần trả về (chỉ áp dụng
khi transactionDetails=full). Đặt thành 1 để nhận
các giao dịch legacy, v0 và v1.
example: 1
filters:
type: object
description: Các bộ lọc nâng cao để thu hẹp kết quả giao dịch.
properties:
slot:
type: object
description: Lọc theo số slot.
properties:
gte:
type: integer
description: Lớn hơn hoặc bằng số slot.
example: 100
gt:
type: integer
description: Lớn hơn số slot.
example: 100
lte:
type: integer
description: Nhỏ hơn hoặc bằng số slot.
example: 200
lt:
type: integer
description: Nhỏ hơn số slot.
example: 200
additionalProperties: false
blockTime:
type: object
description: >-
Lọc theo dấu thời gian của khối (dấu thời gian
Unix).
properties:
gte:
type: integer
description: Lớn hơn hoặc bằng dấu thời gian.
example: 1640995200
gt:
type: integer
description: Lớn hơn dấu thời gian.
example: 1640995200
lte:
type: integer
description: Nhỏ hơn hoặc bằng dấu thời gian.
example: 1641081600
lt:
type: integer
description: Nhỏ hơn dấu thời gian.
example: 1641081600
eq:
type: integer
description: Bằng dấu thời gian.
example: 1641038400
additionalProperties: false
signature:
type: object
description: Lọc theo chữ ký giao dịch.
properties:
gte:
type: string
description: >-
Lấy các giao dịch có chữ ký lớn hơn hoặc
bằng giá trị này.
example: >-
4h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
gt:
type: string
description: Lấy các giao dịch sau chữ ký này.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lte:
type: string
description: >-
Lấy các giao dịch có chữ ký nhỏ hơn hoặc
bằng giá trị này.
example: >-
6k7xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lt:
type: string
description: Lấy các giao dịch trước chữ ký này.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
additionalProperties: false
status:
type: string
description: Lọc theo trạng thái giao dịch.
enum:
- succeeded
- failed
- any
default: any
example: succeeded
tokenAccounts:
type: string
description: >-
Lọc giao dịch cho các tài khoản token liên
quan. Kiểm soát việc có bao gồm các giao dịch
liên quan đến tài khoản token thuộc sở hữu của
địa chỉ hay không.
enum:
- none
- balanceChanged
- all
default: none
example: balanceChanged
tokenTransfer:
$ref: '#/components/schemas/TokenTransferFilter'
description: >-
Lọc thành các giao dịch mà địa chỉ được truy
vấn đã tham gia vào một lần chuyển token khớp
với đối tác, hướng, mint hoặc phạm vi số lượng
thô.
additionalProperties: false
responses:
'200':
description: Đã truy xuất thành công các giao dịch cho địa chỉ được chỉ định.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: Phiên bản giao thức JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Mã định danh khớp với yêu cầu.
example: '1'
result:
type: object
description: Dữ liệu giao dịch và thông tin phân trang.
properties:
data:
type: array
description: Danh sách thông tin giao dịch.
items:
oneOf:
- type: object
description: >-
Bản tóm tắt giao dịch ở cấp độ chữ ký (khi
transactionDetails là "signatures").
properties:
signature:
type: string
description: >-
Chữ ký giao dịch dưới dạng chuỗi được mã hóa
base-58.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: Slot chứa khối có giao dịch.
example: 1054
transactionIndex:
type: integer
description: >-
Chỉ mục bắt đầu từ 0 của giao dịch trong
khối. Hữu ích để xác định thứ tự giao dịch
trong một khối.
example: 42
err:
oneOf:
- type: object
description: Lỗi nếu giao dịch thất bại
- type: 'null'
description: >-
Lỗi nếu giao dịch thất bại hoặc null nếu
thành công.
example: null
memo:
oneOf:
- type: string
description: Ghi chú liên kết với giao dịch
- type: 'null'
description: >-
Ghi chú liên kết với giao dịch hoặc null nếu
không có.
example: null
blockTime:
oneOf:
- type: integer
description: >-
Thời gian tạo ước tính dưới dạng dấu
thời gian Unix
- type: 'null'
description: >-
Thời gian tạo ước tính dưới dạng dấu thời
gian Unix (số giây kể từ epoch) hoặc null
nếu không có.
example: 1641038400
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: >-
Trạng thái xác nhận của cụm đối với giao
dịch
- type: 'null'
description: >-
Trạng thái xác nhận của cụm đối với giao
dịch.
example: finalized
required:
- signature
- slot
- transactionIndex
additionalProperties: false
- type: object
description: >-
Giao dịch đầy đủ kèm siêu dữ liệu trạng thái
(khi transactionDetails là "full").
properties:
slot:
type: integer
description: Slot chứa khối có giao dịch.
example: 1054
transactionIndex:
type: integer
description: >-
Chỉ mục bắt đầu từ 0 của giao dịch trong
khối. Hữu ích để xác định thứ tự giao dịch
trong một khối.
example: 42
transaction:
type: object
description: >-
Đối tượng giao dịch đã mã hóa hoặc phân tích
cú pháp theo kiểu mã hóa đã chọn.
meta:
type: object
description: >-
Siêu dữ liệu trạng thái giao dịch — có cùng
cấu trúc với getTransaction, bao gồm err,
fee, preBalances/postBalances,
preTokenBalances/postTokenBalances,
innerInstructions, logMessages và
computeUnitsConsumed.
blockTime:
oneOf:
- type: integer
description: >-
Thời gian tạo ước tính dưới dạng dấu
thời gian Unix
- type: 'null'
description: >-
Thời gian tạo ước tính dưới dạng dấu thời
gian Unix (số giây kể từ epoch) hoặc null
nếu không có.
required:
- slot
- transactionIndex
- transaction
paginationToken:
oneOf:
- type: string
description: Token để truy xuất trang kết quả tiếp theo
- type: 'null'
description: >-
Token phân trang cho trang tiếp theo hoặc null nếu
không còn kết quả.
example: '1055:5'
examples:
signaturesResponse:
summary: Phản hồi chỉ có chi tiết chữ ký
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- signature: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1054
transactionIndex: 42
err: null
memo: null
blockTime: 1641038400
confirmationStatus: finalized
- signature: >-
kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1055
transactionIndex: 15
err: null
memo: null
blockTime: 1641038460
confirmationStatus: finalized
paginationToken: '1055:5'
fullResponse:
summary: Phản hồi có đầy đủ chi tiết giao dịch
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- slot: 1054
transactionIndex: 42
transaction:
signatures:
- >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
message:
accountKeys:
- ...
- ...
instructions:
- ...
meta:
err: null
fee: 5000
preBalances:
- 1000000
- 2000000
postBalances:
- 999995000
- 2000000
preTokenBalances:
- accountIndex: 1
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
owner: ...
programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
uiTokenAmount:
amount: '1500000'
decimals: 6
uiAmount: 1.5
uiAmountString: '1.5'
postTokenBalances:
- accountIndex: 1
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
owner: ...
programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
uiTokenAmount:
amount: '500000'
decimals: 6
uiAmount: 0.5
uiAmountString: '0.5'
logMessages:
- ...
computeUnitsConsumed: 2100
blockTime: 1641038400
paginationToken: '1055:5'
'400':
description: >-
Yêu cầu không hợp lệ - Tham số yêu cầu không hợp lệ hoặc yêu cầu sai
định dạng.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Tham số không hợp lệ
id: '1'
'401':
description: Không được phép - Khóa API không hợp lệ hoặc bị thiếu.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Không được phép
id: '1'
'429':
description: Quá nhiều yêu cầu - Đã vượt quá giới hạn tốc độ.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Quá nhiều yêu cầu
id: '1'
'500':
description: Lỗi máy chủ nội bộ - Đã xảy ra lỗi trên máy chủ.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Lỗi nội bộ
id: '1'
'503':
description: Dịch vụ không khả dụng - Dịch vụ tạm thời không khả dụng.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Dịch vụ không khả dụng
id: '1'
'504':
description: Cổng kết nối hết thời gian chờ - Yêu cầu đã hết thời gian chờ.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Cổng kết nối hết thời gian chờ
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
TokenTransferFilter:
type: object
description: >-
Thu hẹp kết quả thành các giao dịch mà địa chỉ được truy vấn đã tham gia
vào một lần chuyển token khớp với các tiêu chí cụ thể. Tất cả các trường
đều không bắt buộc và được kết hợp theo ngữ nghĩa AND.
properties:
with:
type: string
description: >-
Địa chỉ đối tác. Khớp với các lần chuyển mà phía còn lại là địa chỉ
này.
example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
direction:
type: string
description: Hướng chuyển tương ứng với địa chỉ được truy vấn.
enum:
- in
- out
- any
default: any
example: in
mint:
type: string
description: Địa chỉ mint token dùng để lọc.
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
amount:
$ref: '#/components/schemas/TokenTransferAmountFilter'
description: >-
So sánh số lượng bằng số lượng thô trên chuỗi, không phải số lượng
trên giao diện người dùng hoặc số lượng đã điều chỉnh theo số thập
phân.
additionalProperties: false
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: Phiên bản giao thức JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: Mã lỗi.
example: -32602
message:
type: string
description: Thông báo lỗi.
data:
type: object
description: Dữ liệu bổ sung về lỗi.
id:
type: string
description: Mã định danh khớp với yêu cầu.
example: '1'
TokenTransferAmountFilter:
type: object
description: >-
Bộ lọc phạm vi số lượng thô trên chuỗi. Tất cả các trường đều không bắt
buộc và có thể kết hợp với nhau.
properties:
gt:
type: number
description: Lớn hơn nghiêm ngặt.
example: 1000000
gte:
type: number
description: Lớn hơn hoặc bằng.
example: 1000000
lt:
type: number
description: Nhỏ hơn nghiêm ngặt.
example: 5000000
lte:
type: number
description: Nhỏ hơn hoặc bằng.
example: 5000000
additionalProperties: false
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Khóa API Helius của bạn. Bạn có thể nhận khóa miễn phí trong [bảng điều
khiển](https://dashboard.helius.dev/api-keys).
````