GET/
Root
Root endpoint - provides API information.
响应
| 状态 | 说明 | 请求体 |
|---|---|---|
200 | Successful Response |
|
Small REST surface exposed by the TensorCash core-node alongside the JSON-RPC server. Used by the miner-api to query model metadata and node metrics. The full chain surface is the JSON-RPC at /docs/rpc/.
完整的链接口是 JSON-RPC。这里是节点旁的一个小型 REST 接口,本地矿工 API 通过它获取模型元数据和节点指标。生产环境中使用端口 8050。
/Root
Root endpoint - provides API information.
| 状态 | 说明 | 请求体 |
|---|---|---|
200 | Successful Response |
|
/healthHealth Check
Health check endpoint - no auth required.
| 状态 | 说明 | 请求体 |
|---|---|---|
200 | Successful Response |
|
/api/v1/modelsGet Models List
Get list of models with rate limiting.
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
extended | query | boolean | — |
HTTPAuthorizationCredentials | null| 状态 | 说明 | 请求体 |
|---|---|---|
200 | Successful Response | |
422 | Validation Error |
/api/v1/blockchaininfoGet Blockchain Info
Pass-through to the node's getblockchaininfo RPC.
Used by the verification orchestrator to compute distance-to-verdict for
PendingVerification model records and trigger anticipatory smell-stat
pre-bake before a model flips to Registered.
HTTPAuthorizationCredentials | null| 状态 | 说明 | 请求体 |
|---|---|---|
200 | Successful Response |
|
422 | Validation Error |
/api/v1/models/{model_hash}Get Model Info
Get model information with input validation.
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
model_hash | path | string | 是 |
HTTPAuthorizationCredentials | null| 状态 | 说明 | 请求体 |
|---|---|---|
200 | Successful Response |
|
422 | Validation Error |
/api/v1/miner/metricsGet Miner Metrics
Get mining throughput metrics from the miner proxy. Returns token throughput (tokens/sec), completion rate, and totals.
HTTPAuthorizationCredentials | null| 状态 | 说明 | 请求体 |
|---|---|---|
200 | Successful Response |
|
422 | Validation Error |
HTTPAuthorizationCredentialsThe HTTP authorization credentials in the result of using HTTPBearer or
HTTPDigest in a dependency.
The HTTP authorization header value is split by the first space.
The first part is the scheme, the second part is the credentials.
For example, in an HTTP Bearer token scheme, the client will send a header
like:
``
Authorization: Bearer deadbeef12346
`
In this case:
* scheme will have the value "Bearer"
* credentials will have the value "deadbeef12346"`
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
scheme | string | 是 | |
credentials | string | 是 |
HTTPValidationError| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
detail | ValidationError[] | — |
ModelInfo| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model_hash | string | 是 | |
model_name | string | 是 | |
model_commit | string | 是 | |
difficulty | integer | 是 | |
status | integer | null | — | |
cid | string | null | — | |
extra | string | null | — | |
txid | string | null | — | |
block_hash | string | null | — | |
block_height | integer | null | — | |
deposit_txid | string | null | — | |
deposit_vout | integer | null | — | |
deposit_amount | integer | null | — | |
owner_key_hash | string | null | — | |
deposit_block_hash | string | null | — | |
deposit_block_height | integer | null | — | |
commit_txid | string | null | — | |
commit_block_hash | string | null | — | |
commit_block_height | integer | null | — | |
verification_code | integer | null | — | |
verification_details | string | null | — |
ValidationError| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
loc | string | integer[] | 是 | |
msg | string | 是 | |
type | string | 是 |