Lấy mức sử dụng của dự án

GET

admin

projects

{id}

usage

Lấy thông tin sử dụng của dự án

curl --request GET \
  --url 'https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key='

const options = {method: 'GET'};

fetch('https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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
  }
}

{
  "statusCode": 400,
  "message": "ID dự án không hợp lệ",
  "error": "Yêu cầu không hợp lệ"
}

{
  "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"
}

{
  "statusCode": 403,
  "message": "Admin API chưa được bật cho dự án này",
  "error": "Bị từ chối"
}

{
  "statusCode": 429,
  "message": "ThrottlerException: Quá nhiều yêu cầu",
  "error": "Quá nhiều yêu cầu"
}

{
  "statusCode": 500,
  "message": "Lỗi máy chủ nội bộ",
  "error": "Lỗi máy chủ nội bộ"
}

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

string

bắt buộc

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

number

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.

number

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.

number

Số tín dụng trả trước vẫn còn khả dụng.

number

Số tín dụng trả trước đã sử dụng trong chu kỳ tín dụng hiện tại.

object

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í.

string

Ngày bắt đầu chu kỳ tín dụng ở định dạng YYYY-MM-DD (UTC).

string

Ngày kết thúc chu kỳ tín dụng ở định dạng YYYY-MM-DD (UTC).

object

Thông tin về gói đăng ký và chu kỳ lập hóa đơn.

object | null

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.

string

Ngày bắt đầu chu kỳ thanh toán ở định dạng YYYY-MM-DD.

string

Ngày kết thúc chu kỳ thanh toán ở định dạng YYYY-MM-DD.

number

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.

string

Tên của gói đăng ký (ví dụ: "business", "professional").

object

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.

number

Số tín dụng được sử dụng bởi Solana RPC tiêu chuẩn.

number

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).

number

Số tín dụng được sử dụng bởi Wallet API.

number

Số tín dụng được sử dụng bởi API DAS (Digital Asset Standard).

number

Số tín dụng được sử dụng bởi webhook.

number

Số tín dụng được sử dụng bởi LaserStream gRPC (đo lường theo băng thông).

number

Số tín dụng được sử dụng bởi LaserStream WebSocket (đo lường theo băng thông).

number

Số tín dụng được sử dụng bởi Preconfirmations.

number

Số tín dụng được sử dụng bởi Archival.

number

Số tín dụng được sử dụng bởi Photon (ZK Compression).

number

Số tín dụng được sử dụng cho hoạt động chưa được phân loại.

object

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.

object

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

string

bắt buộc

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.

Ủy quyền

api-key

string

query

bắt buộc

Khóa API được truyền dưới dạng tham số truy vấn.

Tham số đường dẫn

string<uuid>

bắt buộc

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.

Ví dụ:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Phản hồi

Đã truy xuất thành công thông tin sử dụng của dự án.

creditsRemaining

number

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.

Ví dụ:

487500

creditsUsed

number

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.

Ví dụ:

12500

prepaidCreditsRemaining

number

Số tín dụng trả trước còn lại.

Ví dụ:

50000

prepaidCreditsUsed

number

Số tín dụng trả trước đã sử dụng trong chu kỳ tín dụng hiện tại.

Ví dụ:

0

creditCycle

object

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.

Show child attributes

subscriptionDetails

object

Thông tin chi tiết về gói đăng ký và chu kỳ lập hóa đơn của dự án.

Show child attributes

credits

object

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.

Show child attributes

requests

object

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.

Show child attributes

dataTransfer

object

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.

Show child attributes

⌘I

Lấy thông tin sử dụng của dự án

curl --request GET \
  --url 'https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key='

const options = {method: 'GET'};

fetch('https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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
  }
}

{
  "statusCode": 400,
  "message": "ID dự án không hợp lệ",
  "error": "Yêu cầu không hợp lệ"
}

{
  "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"
}

{
  "statusCode": 403,
  "message": "Admin API chưa được bật cho dự án này",
  "error": "Bị từ chối"
}

{
  "statusCode": 429,
  "message": "ThrottlerException: Quá nhiều yêu cầu",
  "error": "Quá nhiều yêu cầu"
}

{
  "statusCode": 500,
  "message": "Lỗi máy chủ nội bộ",
  "error": "Lỗi máy chủ nội bộ"
}

Bắt đầu

Truyền phát dữ liệu & lắng nghe sự kiện

API dữ liệu & RPC

Giao dịch

Gửi giao dịch

Quản lý tài khoản

Lấy mức sử dụng của dự án

Tổng quan

Tham số yêu cầu

Trường phản hồi

Tham số yêu cầu

Ủy quyền

Tham số đường dẫn

Phản hồi

​Tổng quan

​Tham số yêu cầu

​Trường phản hồi

​Tham số yêu cầu

Ủy quyền

Tham số đường dẫn

Phản hồi

Tổng quan

Tham số yêu cầu

Trường phản hồi

Tham số yêu cầu