> ## 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.
# getPriorityFeeEstimate
> Nhận mức phí ưu tiên đề xuất cho các giao dịch Solana để tối ưu khả năng được đưa vào khối và chi phí dựa trên hoạt động mạng gần đây cùng các khóa tài khoản
## Tham số yêu cầu
Giao dịch Solana được mã hóa bằng Base58 hoặc Base64 cần ước tính mức phí ưu tiên tối ưu.
API sẽ phân tích các lệnh và tài khoản cụ thể trong giao dịch này để cung cấp
mức phí ước tính chính xác dựa trên điều kiện mạng hiện tại và độ phức tạp tính toán.
Mảng khóa công khai của tài khoản Solana cần ước tính phí ưu tiên (phương án thay thế cho việc cung cấp giao dịch)
Các tùy chọn nâng cao để tùy chỉnh việc ước tính phí ưu tiên Solana dựa trên điều kiện mạng
Định dạng mã hóa của giao dịch Solana được cung cấp
* `Base58`
* `Base64`
Mức ưu tiên cụ thể cần ước tính phí dựa trên tình trạng tắc nghẽn hiện tại của mạng Solana
* `Min`
* `Low`
* `Medium`
* `High`
* `VeryHigh`
* `UnsafeMax`
Khi là true, trả về mức ước tính đầy đủ cho tất cả các mức ưu tiên, từ tối thiểu đến tối đa
Số slot gần đây trên blockchain Solana cần phân tích để ước tính phí chính xác (1-150)
Khi là true, bao gồm các giao dịch bỏ phiếu trong phép tính phí để phân tích toàn diện hơn
Khi là true, trả về mức phí tối ưu được đề xuất dựa trên điều kiện hiện tại của mạng Solana
Khi là true, các slot không có giao dịch được tính là slot có mức phí bằng 0 trong phép tính
## OpenAPI
````yaml vi/openapi/priority-fee-api/getPriorityFeeEstimate.yaml POST /
openapi: 3.1.0
info:
title: API tối ưu hóa phí ưu tiên Solana
version: 1.0.0
description: >
API ước tính phí ưu tiên Solana nâng cao để tối ưu hóa thời gian xác nhận và
chi phí giao dịch trên blockchain Solana.
API chuyên biệt này giúp nhà phát triển tối đa hóa thông lượng giao dịch khi
mạng tắc nghẽn bằng cách cung cấp các đề xuất phí theo thời gian thực,
dựa trên dữ liệu ở nhiều mức ưu tiên. Phù hợp cho ví, ứng dụng DeFi, nền
tảng NFT
và mọi dự án Solana cần xử lý giao dịch đáng tin cậy với chi phí được tối ưu
hóa.
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:
summary: Lấy ước tính phí ưu tiên Solana
description: >
Tính toán các đề xuất phí ưu tiên tối ưu cho giao dịch Solana dựa trên
điều kiện mạng
theo thời gian thực. API nâng cao này phân tích dữ liệu phí trong quá
khứ và mức độ tắc nghẽn
hiện tại để cung cấp ước tính phí chính xác cho các mức ưu tiên khác
nhau.
operationId: getPriorityFeeEstimate
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PriorityFeeEstimateRequest'
responses:
'200':
description: Đã truy xuất thành công các ước tính phí ưu tiên Solana
content:
application/json:
schema:
$ref: '#/components/schemas/PriorityFeeEstimateResponse'
examples:
singleEstimateResponse:
value:
jsonrpc: '2.0'
result:
priorityFeeEstimate: 120000
id: '1'
allLevelsResponse:
value:
jsonrpc: '2.0'
result:
priorityFeeLevels:
min: 0
low: 2
medium: 10082
high: 100000
veryHigh: 1000000
unsafeMax: 50000000
id: '1'
'400':
description: Yêu cầu không hợp lệ
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Mã định danh phiên bản JSON-RPC
error:
type: object
description: Thông tin lỗi
properties:
code:
type: integer
example: -32602
description: Mã lỗi
message:
type: string
example: Invalid params
description: Thông báo lỗi
id:
type: string
description: Mã định danh do máy khách tạo, khớp với yêu cầu
'401':
description: Không được phép — thiếu khóa API hoặc khóa không hợp lệ.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
error:
type: object
properties:
code:
type: integer
example: -32001
message:
type: string
example: Unauthorized
id:
type: string
'429':
description: Quá nhiều yêu cầu — đã vượt quá giới hạn tốc độ.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
error:
type: object
properties:
code:
type: integer
example: -32005
message:
type: string
example: Too many requests
id:
type: string
'500':
description: >-
Lỗi máy chủ nội bộ. Có thể thử lại với chiến lược thời gian chờ tăng
theo cấp số nhân.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
error:
type: object
properties:
code:
type: integer
example: -32603
message:
type: string
example: Internal error
id:
type: string
security:
- ApiKeyQuery: []
components:
schemas:
PriorityFeeEstimateRequest:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: >-
Mã định danh phiên bản JSON-RPC cho yêu cầu API RPC Solana, phải là
"2.0"
id:
type: string
default: '1'
description: Mã định danh do máy khách tạo cho yêu cầu
method:
type: string
enum:
- getPriorityFeeEstimate
default: getPriorityFeeEstimate
description: Tên phương thức RPC
params:
type: array
description: Các tham số cho lệnh gọi phương thức
default:
- transaction: >-
LxzhDW7TapzziJVHEGPh1QjmZB6kjNqmvuJ9gmihBGEkzw2N8ospDq32UZdVmKWzRZqKuyvhp7xmLvsmmHa3MfxVKpYoLV9cPkw5isHnHgDUwLSMsDaZ4dLEULexXAvuV9k6fLD2LMhFKM6gqH6j69GQLAm1g4e3z5ZVZN6pmJdSmZ4PqKcwNn4sS7E3Abp1hV59uBJB9i4jEdEAh28rZ8WCeNizzEmrJZFhatFFFGSDsk23jDPEjbkMcoRWXKf1WthFScC2S6Wz284Dtjqp7kW8eybV3DpmN9DtBbcfFNQPtUwmiBZCKszdYym5AjJvRHiUKUdMwFpC3toPnMvTmKZ9iHQtzZRkg5xBufRtUN5eVYJfdw2DxzH6RfqhC2rAjfSbfJA4wmaq9f5eUe2iEjmqvne6r85PPcHBJzyqkVtAyUFtTc9DfU8UiM9rFhQ2UB71M6m5UCsC6EwowMw5k8iF8rL7iPCLdubVdy8S58DPLNG4E4rdosev1T63YdRWSgEwBZh7iX4zGBA9AKAm3B9itCSxLSL46Y6uZgVku9UXsMcWWz3URoa6hRbo55CYPLhrVeqjqX5DsXpaG6QkngbEaESQUnkakE1AFkYXmNXEd2m3sLRTYB2o5UTkwkJS2u5sJHyYqAvXr3vFZr7qAYFLD3LwS5tsdb45ZQVQwsbnNddMHgkpmSqLHS6Fv1epxqHbzpRCU1tgMsriApVWC3pj2LLD41HxkV8aKvkVyHgJFACUtbvRBZAasHf1F71Gz3qZNTdh3efWsZJRXnfxKPbATU7NTMaMUL8JjknfoVwp3
items:
type: object
properties:
transaction:
type: string
description: >
Giao dịch Solana được mã hóa bằng Base58 hoặc Base64 cần ước
tính phí ưu tiên tối ưu.
API sẽ phân tích các chỉ thị và tài khoản cụ thể trong giao
dịch này để cung cấp
ước tính phí chính xác dựa trên điều kiện mạng hiện tại và độ
phức tạp tính toán.
accountKeys:
type: array
description: >-
Mảng khóa công khai của tài khoản Solana cần ước tính phí ưu
tiên (thay cho việc cung cấp giao dịch)
items:
type: string
description: Khóa công khai của tài khoản Solana được mã hóa bằng Base58
options:
$ref: '#/components/schemas/PriorityFeeOptions'
PriorityFeeEstimateResponse:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Mã định danh phiên bản JSON-RPC
id:
type: string
description: Mã định danh do máy khách tạo, khớp với yêu cầu
result:
type: object
description: Đối tượng kết quả chứa các ước tính toàn diện về phí ưu tiên Solana
properties:
priorityFeeEstimate:
type: number
format: float
description: >
Phí ưu tiên tối ưu ước tính bằng microlamport cho giao dịch
Solana được yêu cầu,
được tính dựa trên hoạt động blockchain gần đây và yêu cầu tính
toán.
priorityFeeLevels:
type: object
description: >
Ước tính phí chi tiết cho các mức ưu tiên khác nhau trên
blockchain Solana (tính bằng microlamport),
cho phép nhà phát triển chọn sự cân bằng tối ưu giữa chi phí và
tốc độ xác nhận.
properties:
min:
type: number
format: float
description: >
Mức phí khả dụng tối thiểu cho giao dịch Solana — phù hợp
với các giao dịch không khẩn cấp trong thời gian ít tắc
nghẽn
(có thể khiến giao dịch thất bại khi mạng tắc nghẽn)
low:
type: number
format: float
description: >
Phí ưu tiên thấp cho giao dịch Solana — lựa chọn tiết kiệm
cho các giao dịch không nhạy cảm về thời gian
(thời gian xác nhận lâu hơn, chi phí thấp hơn)
medium:
type: number
format: float
description: >
Phí ưu tiên trung bình cho giao dịch Solana — lựa chọn cân
bằng cho hầu hết giao dịch tiêu chuẩn
(thời gian xác nhận hợp lý với chi phí vừa phải)
high:
type: number
format: float
description: >
Phí ưu tiên cao cho giao dịch Solana — ưu tiên xử lý các
hoạt động nhạy cảm về thời gian
như giao dịch DeFi hoặc đúc NFT (xác nhận nhanh hơn, chi phí
cao hơn)
veryHigh:
type: number
format: float
description: >
Phí ưu tiên rất cao cho giao dịch Solana — lựa chọn cao cấp
cho các giao dịch quan trọng cần
xác nhận gần như tức thì (xác nhận rất nhanh, chi phí cao
cấp)
unsafeMax:
type: number
format: float
description: >
Mức phí tối đa quan sát được trên Solana — mức phí cao nhất
ghi nhận trong khoảng thời gian phân tích, đại diện cho
giới hạn trên khi tắc nghẽn nghiêm trọng (xác nhận nhanh
nhất có thể, nhưng có thể cao hơn mức cần thiết)
PriorityFeeOptions:
type: object
description: >-
Các tùy chọn nâng cao để tùy chỉnh việc ước tính phí ưu tiên Solana dựa
trên điều kiện mạng
properties:
transactionEncoding:
type: string
enum:
- Base58
- Base64
description: Định dạng mã hóa của giao dịch Solana được cung cấp
priorityLevel:
type: string
enum:
- Min
- Low
- Medium
- High
- VeryHigh
- UnsafeMax
description: >-
Mức ưu tiên cụ thể cần ước tính phí dựa trên tình trạng tắc nghẽn
hiện tại của mạng Solana
includeAllPriorityFeeLevels:
type: boolean
description: >-
Khi là true, trả về các ước tính toàn diện cho mọi mức ưu tiên từ
tối thiểu đến tối đa
lookbackSlots:
type: integer
minimum: 1
maximum: 150
description: >-
Số slot gần đây trên blockchain Solana cần phân tích để ước tính phí
chính xác (1-150)
includeVote:
type: boolean
description: >-
Khi là true, bao gồm các giao dịch biểu quyết trong phép tính phí để
phân tích toàn diện hơn
recommended:
type: boolean
description: >-
Khi là true, trả về mức phí tối ưu được đề xuất dựa trên điều kiện
hiện tại của mạng Solana
evaluateEmptySlotAsZero:
type: boolean
description: >-
Khi là true, các slot không có giao dịch được tính là slot có phí
bằng 0 trong phép tính
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).
````