跳转到主要内容
GET
/
v0
/
admin
/
projects
/
{id}
/
usage
获取项目使用情况
curl --request GET \
  --url 'https://admin-api.helius.xyz/v0/admin/projects/{id}/usage?api-key='
{
  "creditsRemaining": 487500,
  "creditsUsed": 12500,
  "prepaidCreditsRemaining": 50000,
  "prepaidCreditsUsed": 0,
  "subscriptionDetails": {
    "billingCycle": {
      "start": "2026-04-01",
      "end": "2026-05-01"
    },
    "creditsLimit": 500000,
    "plan": "business"
  },
  "usage": {
    "api": 1200,
    "archival": 0,
    "das": 5000,
    "grpc": 300,
    "grpcGeyser": 0,
    "photon": 0,
    "rpc": 4500,
    "stream": 100,
    "webhook": 800,
    "websocket": 600
  }
}

概述

返回在当前账单周期内项目信用消耗的完整情况,包括剩余信用、订阅计划详情以及按服务类型(RPC、DAS、gRPC、WebSocket 等)划分的请求细分。

请求参数

id
string
必填
要检索使用情况的项目 ID。必须与用于身份验证的 API 密钥关联的项目匹配。

响应字段

creditsRemaining
number
当前账单周期内剩余的信用。计算方式为计划的信用限额减去常规消耗的信用,最低为零。
creditsUsed
number
当前账单周期内消耗的总信用,包括常规和预付信用。
prepaidCreditsRemaining
number
仍可用的预付信用。
prepaidCreditsUsed
number
当前账单周期内消耗的预付信用。
subscriptionDetails
object
订阅计划和账单周期信息。
subscriptionDetails.billingCycle.start
string
账单周期开始日期,格式为 YYYY-MM-DD
subscriptionDetails.billingCycle.end
string
账单周期结束日期,格式为 YYYY-MM-DD
subscriptionDetails.creditsLimit
number
基于您的计划的账单周期内的总信用限额。
subscriptionDetails.plan
string
订阅计划名称(例如,"business""professional")。
usage
object
按服务类型划分的请求计数。每个字段是当前账单周期内对该服务的请求总数。
usage.api
number
增强的API请求(例如,解析的交易、令牌元数据)。
usage.archival
number
归档RPC请求。
usage.das
number
DAS(数字资产标准)API请求。
usage.grpc
number
gRPC流式请求。
usage.grpcGeyser
number
Geyser gRPC请求。
usage.photon
number
ZK压缩(Photon)请求。
usage.rpc
number
标准Solana RPC请求。
usage.stream
number
LaserStream数据流请求。
usage.webhook
number
Webhook传递事件。
usage.websocket
number
WebSocket订阅请求。

请求参数

id
string
必填
要检索使用情况的项目ID。必须匹配与API密钥关联的项目。

授权

api-key
string
query
必填

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

路径参数

id
string<uuid>
必填

要检索使用情况的项目 ID。必须与 API 密钥关联的项目匹配。

示例:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

响应

成功检索项目使用情况。

creditsRemaining
number

当前计费周期中剩余的信用额度。计算公式为creditsLimit - regularCreditsUsed,最低为0。

示例:

487500

creditsUsed
number

当前计费周期中消耗的总信用额度,包括常规和预付的信用额度。

示例:

12500

prepaidCreditsRemaining
number

剩余的预付信用额度。

示例:

50000

prepaidCreditsUsed
number

当前计费周期中消耗的预付信用额度。

示例:

0

subscriptionDetails
object

关于项目订阅计划和当前计费周期的详细信息。

usage
object

当前计费周期按服务类型分解的请求计数。