接口调用

认证方式见身份认证，各接口的路径、参数和返回字段见 OpenAPI 接口。

请求方式

接口的基础地址为 https://api.chaintable.com，路径以 /v1/ 开头。GET 请求将参数放在查询字符串中，POST 请求使用 JSON 对象，并设置 Content-Type: application/json。例如，匿名列出 demo Space 的数据表。将 demo 替换为要查询的公开 Space ID：

curl --get 'https://api.chaintable.com/v1/table/list' \
  --data-urlencode 'space=demo' \
  --data-urlencode 'limit=10'

成功后，表列表位于 data.items。

调用示例

例如，调用创建 Function中保存的 demo.usdc_amount，传入 1500000：

curl 'https://api.chaintable.com/v1/function/invoke' \
  -H 'Content-Type: application/json' \
  --data '{"id": "demo.usdc_amount", "arguments": [1500000]}'

id 是完整 Function ID。arguments 是按函数参数顺序排列的值数组；没有参数时也需要传入 []。成功响应如下，函数返回值位于 data.result：

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "result": 1.5,
    "error": null
  }
}

处理响应

响应包含 code、message 和 data。HTTP 200、code: 0 表示本次接口请求成功；请求失败时，结合 HTTP 状态、数字错误码 code 和说明 message 排查原因。

HTTP 状态	处理方式
`400`	检查请求参数，根据 `message` 修正请求
`401`	检查是否携带所需凭证，以及凭证是否有效
`403`	检查资源权限、目标账户权限和所需额度
`404`	核对资源 ID
`409`	检查资源是否重复，或当前状态是否允许该操作
`429`	请求受到限流；降低调用频率，等待一段时间后重试
`5xx`	服务端或上游服务异常；保留错误信息和响应头 `X-Request-ID` 以便排查

Compute Units

API Key 调用按请求处理时长消耗所属账户的 Compute Units（CU），每毫秒消耗 1 CU，每次调用最低消耗 100 CU。

消耗 CU = max(100, round(请求处理时长（毫秒）))

通过凭证、额度和限流检查后，HTTP 状态码小于 500 的响应会计费，包括 4xx；未通过这些检查或返回 5xx 时不计费。账户的 CU 额度、已用量和重置时间可在 Capacity → Openapi 查看，具体见套餐用量。

概览

快速开始

使用指南

参考

请求方式

调用示例

处理响应

Compute Units