> ## 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.
# Lấy mức sử dụng của dự án
> Truy xuất mức sử dụng tín dụng, thông tin chi tiết về gói đăng ký và số lượng yêu cầu theo từng dịch vụ của một dự án trong chu kỳ tín dụng hiện tại.
## Tổng quan
Trả về thông tin đầy đủ về mức tiêu thụ tín dụng của dự án trong chu kỳ tín dụng hiện tại, bao gồm số tín dụng còn lại, thông tin chi tiết về gói đăng ký và bảng phân tích yêu cầu theo loại dịch vụ (RPC, DAS, gRPC, WebSocket, v.v.).
Tất cả số liệu tín dụng đều nằm trong phạm vi `creditCycle` — khoảng thời gian tín dụng được tích lũy và đặt lại, được xác định từ mốc thanh toán của gói đăng ký. Mọi dự án đều có khoảng thời gian này, kể cả các gói miễn phí. `subscriptionDetails.billingCycle` là khoảng thời gian lập hóa đơn; thông tin này chỉ mang tính tham khảo và có giá trị `null` đối với các gói miễn phí vì những gói này không bao giờ được lập hóa đơn.
## Tham số yêu cầu
ID của dự án cần truy xuất mức sử dụng. ID này phải khớp với dự án được liên kết với khóa API dùng để xác thực.
## Trường phản hồi
Số tín dụng còn lại trong chu kỳ tín dụng hiện tại. Được tính bằng giới hạn tín dụng của gói trừ đi số tín dụng thông thường đã sử dụng, với giá trị tối thiểu là 0.
Tổng số tín dụng đã sử dụng trong chu kỳ tín dụng hiện tại, bao gồm cả tín dụng thông thường và tín dụng trả trước.
Số tín dụng trả trước vẫn còn khả dụng.
Số tín dụng trả trước đã sử dụng trong chu kỳ tín dụng hiện tại.
Khoảng thời gian áp dụng cho mọi số liệu tín dụng trong phản hồi này — khoảng thời gian tín dụng được tích lũy và đặt lại, được xác định từ mốc thanh toán của gói đăng ký. Luôn có trong mọi gói, kể cả các gói miễn phí.
Ngày bắt đầu chu kỳ tín dụng ở định dạng `YYYY-MM-DD` (UTC).
Ngày kết thúc chu kỳ tín dụng ở định dạng `YYYY-MM-DD` (UTC).
Thông tin về gói đăng ký và chu kỳ lập hóa đơn.
Ngày bắt đầu và kết thúc của chu kỳ lập hóa đơn hiện tại. Chỉ mang tính tham khảo — có giá trị `null` đối với các gói miễn phí vì những gói này không bao giờ được lập hóa đơn. Đối với các gói trả phí, khoảng thời gian này thường khớp với `creditCycle`.
Ngày bắt đầu chu kỳ thanh toán ở định dạng `YYYY-MM-DD`.
Ngày kết thúc chu kỳ thanh toán ở định dạng `YYYY-MM-DD`.
Tổng hạn mức tín dụng cho chu kỳ tín dụng dựa trên gói của bạn.
Tên của gói đăng ký (ví dụ: `"business"`, `"professional"`).
Mức tiêu thụ tín dụng theo từng sản phẩm trong chu kỳ tín dụng hiện tại, tính theo đơn vị tín dụng nguyên. Bao gồm mọi sản phẩm. Các giá trị thô được cộng dồn và chỉ làm tròn một lần ở bước cuối để khớp với dữ liệu thanh toán, vì vậy sau khi làm tròn, tổng tín dụng theo từng sản phẩm có thể không khớp chính xác với `creditsUsed`.
Số tín dụng được sử dụng bởi Solana RPC tiêu chuẩn.
Số tín dụng được sử dụng bởi Enhanced API (ví dụ: giao dịch đã phân tích cú pháp, siêu dữ liệu token).
Số tín dụng được sử dụng bởi Wallet API.
Số tín dụng được sử dụng bởi API DAS (Digital Asset Standard).
Số tín dụng được sử dụng bởi webhook.
Số tín dụng được sử dụng bởi LaserStream gRPC (đo lường theo băng thông).
Số tín dụng được sử dụng bởi LaserStream WebSocket (đo lường theo băng thông).
Số tín dụng được sử dụng bởi Preconfirmations.
Số tín dụng được sử dụng bởi Archival.
Số tín dụng được sử dụng bởi Photon (ZK Compression).
Số tín dụng được sử dụng cho hoạt động chưa được phân loại.
Số lượng yêu cầu trong chu kỳ tín dụng hiện tại, chỉ dành cho các sản phẩm được đo lường theo yêu cầu. Các sản phẩm LaserStream được đo lường theo băng thông (`laserstreamGrpc`, `laserstreamWebsocket`) không xuất hiện tại đây — xem `dataTransfer`. Các trường: `rpc`, `enhancedApi`, `walletApi`, `das`, `webhooks`, `preConfirmations`, `archival`, `photon`, `other`.
Số byte được truyền trong chu kỳ tín dụng hiện tại, chỉ dành cho các sản phẩm LaserStream được đo lường theo băng thông. Các sản phẩm này được tính phí theo lượng dữ liệu truyền thay vì số lượng yêu cầu, vì vậy chúng xuất hiện tại đây và trong `credits` nhưng không bao giờ xuất hiện trong `requests`. Các trường: `laserstreamGrpc`, `laserstreamWebsocket`.
## Tham số yêu cầu
ID của dự án cần truy xuất mức sử dụng. ID này phải khớp với dự án được liên kết với khóa API.
## OpenAPI
````yaml vi/openapi/admin-api/getProjectUsage.yaml GET /v0/admin/projects/{id}/usage
openapi: 3.0.3
info:
title: Helius Admin API
description: >
Quyền truy cập theo chương trình vào dữ liệu sử dụng và thanh toán của dự
án.
## Xác thực
Tất cả yêu cầu đều cần khóa API được truyền theo một trong hai cách sau:
- Tiêu đề: `X-Api-Key: YOUR_API_KEY`
- Tham số truy vấn: `?api-key=YOUR_API_KEY`
version: 1.0.0
contact:
name: Hỗ trợ API
url: https://helius.dev
servers:
- url: https://admin-api.helius.xyz
description: Máy chủ production
security:
- ApiKeyQuery: []
- ApiKeyHeader: []
paths:
/v0/admin/projects/{id}/usage:
get:
tags:
- Quản trị
summary: Lấy thông tin sử dụng của dự án
description: >
Truy xuất mức sử dụng tín dụng, thông tin chi tiết về gói đăng ký và số
lượng yêu cầu theo từng dịch vụ của một dự án trong chu kỳ tín dụng hiện
tại — khoảng thời gian tín dụng được tích lũy và đặt lại, được báo cáo
trong trường `creditCycle`.
Khóa API dùng để xác thực phải thuộc về dự án được chỉ định trong đường
dẫn. Các yêu cầu có dự án của khóa API không khớp với tham số `id` sẽ
trả về lỗi `400`.
operationId: getProjectUsage
parameters:
- name: id
in: path
required: true
description: >-
ID của dự án cần truy xuất thông tin sử dụng. Phải khớp với dự án
liên kết với khóa API.
schema:
type: string
format: uuid
example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
responses:
'200':
description: Đã truy xuất thành công thông tin sử dụng của dự án.
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectUsageResponse'
example:
creditsRemaining: 486100
creditsUsed: 13900
prepaidCreditsRemaining: 50000
prepaidCreditsUsed: 0
creditCycle:
start: '2026-04-01'
end: '2026-05-01'
subscriptionDetails:
billingCycle:
start: '2026-04-01'
end: '2026-05-01'
creditsLimit: 500000
plan: business
credits:
rpc: 4500
enhancedApi: 1200
walletApi: 0
das: 5000
webhooks: 800
laserstreamGrpc: 1500
laserstreamWebsocket: 800
preConfirmations: 100
archival: 0
photon: 0
other: 0
requests:
rpc: 4500
enhancedApi: 1200
walletApi: 0
das: 5000
webhooks: 800
preConfirmations: 50
archival: 0
photon: 0
other: 0
dataTransfer:
laserstreamGrpc: 15000000
laserstreamWebsocket: 8000000
'400':
description: >-
Yêu cầu không hợp lệ — ID dự án trong đường dẫn không khớp với dự án
liên kết với khóa API.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
statusCode: 400
message: ID dự án không hợp lệ
error: Yêu cầu không hợp lệ
'401':
description: >-
Chưa được xác thực — khóa API bị thiếu, sai định dạng hoặc không tồn
tại.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
statusCode: 401
message: Thiếu khóa API hoặc khóa API không hợp lệ
error: Chưa được xác thực
'403':
description: Bị từ chối — Admin API chưa được bật cho dự án này.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
statusCode: 403
message: Admin API chưa được bật cho dự án này
error: Bị từ chối
'429':
description: Quá nhiều yêu cầu — đã vượt quá giới hạn tốc độ 5 yêu cầu mỗi giây.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
statusCode: 429
message: 'ThrottlerException: Quá nhiều yêu cầu'
error: Quá nhiều yêu cầu
'500':
description: >-
Lỗi máy chủ nội bộ — đã xảy ra lỗi phía máy chủ (ví dụ: thiếu dữ
liệu thanh toán).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
statusCode: 500
message: Lỗi máy chủ nội bộ
error: Lỗi máy chủ nội bộ
components:
schemas:
ProjectUsageResponse:
type: object
properties:
creditsRemaining:
type: number
description: >-
Số tín dụng còn lại trong chu kỳ tín dụng hiện tại. Được tính bằng
`creditsLimit - regularCreditsUsed`, với giá trị tối thiểu là 0.
example: 487500
creditsUsed:
type: number
description: >-
Tổng số tín dụng đã sử dụng trong chu kỳ tín dụng hiện tại, bao gồm
cả tín dụng thông thường và tín dụng trả trước.
example: 12500
prepaidCreditsRemaining:
type: number
description: Số tín dụng trả trước còn lại.
example: 50000
prepaidCreditsUsed:
type: number
description: Số tín dụng trả trước đã sử dụng trong chu kỳ tín dụng hiện tại.
example: 0
creditCycle:
type: object
description: >
Khoảng thời gian áp dụng cho mọi số liệu tín dụng trong phản hồi này
— khoảng thời gian
tín dụng được tích lũy và đặt lại, bắt nguồn từ mốc thanh toán của
gói đăng ký.
Luôn có trong mọi gói, bao gồm cả các gói miễn phí
không bao giờ được lập hóa đơn.
properties:
start:
type: string
description: Ngày bắt đầu chu kỳ tín dụng (`YYYY-MM-DD`, UTC).
example: '2026-04-01'
end:
type: string
description: Ngày kết thúc chu kỳ tín dụng (`YYYY-MM-DD`, UTC).
example: '2026-05-01'
subscriptionDetails:
type: object
description: Thông tin chi tiết về gói đăng ký và chu kỳ lập hóa đơn của dự án.
properties:
billingCycle:
type: object
nullable: true
description: >
Ngày bắt đầu và kết thúc của chu kỳ lập hóa đơn hiện tại. Chỉ
nhằm mục đích cung cấp thông tin —
`null` đối với các gói miễn phí, vốn không bao giờ được lập hóa
đơn. Đối với các gói trả phí,
thông tin này thường khớp với `creditCycle`.
properties:
start:
type: string
description: Ngày bắt đầu chu kỳ thanh toán.
example: '2026-04-01'
end:
type: string
description: Ngày kết thúc chu kỳ thanh toán.
example: '2026-05-01'
creditsLimit:
type: number
description: >-
Tổng hạn mức tín dụng cho chu kỳ tín dụng hiện tại dựa trên gói
đăng ký.
example: 500000
plan:
type: string
description: Tên của gói đăng ký.
example: business
credits:
type: object
description: >
Mức sử dụng tín dụng theo từng sản phẩm trong chu kỳ tín dụng hiện
tại, tính theo tín dụng nguyên.
Bao gồm mọi sản phẩm. Các giá trị thô được cộng dồn và chỉ làm tròn
một lần ở cuối để
khớp với dữ liệu thanh toán, vì vậy tổng tín dụng theo từng sản phẩm
có thể không bằng chính xác `creditsUsed` sau khi
làm tròn.
properties:
rpc:
type: number
description: Tín dụng được sử dụng bởi Solana RPC tiêu chuẩn.
example: 4500
enhancedApi:
type: number
description: >-
Tín dụng được sử dụng bởi Enhanced API (ví dụ: giao dịch đã phân
tích cú pháp, siêu dữ liệu token).
example: 1200
walletApi:
type: number
description: Tín dụng được sử dụng bởi Wallet API.
example: 0
das:
type: number
description: Tín dụng được sử dụng bởi DAS (Digital Asset Standard) API.
example: 5000
webhooks:
type: number
description: Tín dụng được sử dụng bởi webhook.
example: 800
laserstreamGrpc:
type: number
description: >-
Tín dụng được sử dụng bởi LaserStream gRPC (đo lường theo băng
thông).
example: 1500
laserstreamWebsocket:
type: number
description: >-
Tín dụng được sử dụng bởi LaserStream WebSocket (đo lường theo
băng thông).
example: 800
preConfirmations:
type: number
description: Tín dụng được sử dụng bởi Preconfirmations.
example: 100
archival:
type: number
description: Tín dụng được sử dụng bởi dịch vụ lưu trữ.
example: 0
photon:
type: number
description: Tín dụng được sử dụng bởi Photon (ZK Compression).
example: 0
other:
type: number
description: Tín dụng được sử dụng bởi hoạt động chưa được phân loại.
example: 0
requests:
type: object
description: >
Số lượng yêu cầu trong chu kỳ tín dụng hiện tại, chỉ áp dụng cho các
sản phẩm được đo lường theo yêu cầu.
Các sản phẩm LaserStream được đo lường theo băng thông
(`laserstreamGrpc`, `laserstreamWebsocket`)
không xuất hiện ở đây — xem `dataTransfer`.
properties:
rpc:
type: number
description: Số lượng yêu cầu Solana RPC tiêu chuẩn.
example: 4500
enhancedApi:
type: number
description: Số lượng yêu cầu Enhanced API.
example: 1200
walletApi:
type: number
description: Số lượng yêu cầu Wallet API.
example: 0
das:
type: number
description: Số lượng yêu cầu DAS (Digital Asset Standard) API.
example: 5000
webhooks:
type: number
description: Số lượng sự kiện phân phối webhook.
example: 800
preConfirmations:
type: number
description: Số lượng yêu cầu Preconfirmations.
example: 50
archival:
type: number
description: Số lượng yêu cầu RPC lưu trữ.
example: 0
photon:
type: number
description: Số lượng yêu cầu Photon (ZK Compression).
example: 0
other:
type: number
description: Số lượng yêu cầu chưa được phân loại.
example: 0
dataTransfer:
type: object
description: >
Số byte được truyền trong chu kỳ tín dụng hiện tại, chỉ dành cho các
sản phẩm
LaserStream được đo lường theo băng thông. Các sản phẩm này được
tính phí theo lượng dữ liệu truyền, không phải
số lượng yêu cầu, vì vậy chúng xuất hiện tại đây và trong `credits`
nhưng không bao giờ xuất hiện trong `requests`.
properties:
laserstreamGrpc:
type: number
description: Số byte được truyền qua LaserStream gRPC.
example: 15000000
laserstreamWebsocket:
type: number
description: Số byte được truyền qua LaserStream WebSocket.
example: 8000000
ErrorResponse:
type: object
properties:
statusCode:
type: integer
description: Mã trạng thái HTTP.
message:
type: string
description: Thông báo lỗi dễ đọc.
error:
type: string
description: Tên lỗi HTTP.
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: Khóa API được truyền dưới dạng tham số truy vấn.
ApiKeyHeader:
type: apiKey
in: header
name: X-Api-Key
description: Khóa API được truyền dưới dạng tiêu đề yêu cầu.
````