API 概述¶

Sera API 是一个 RESTful API，用于程序化访问 Sera 的交易和账户管理功能。

基础 URL¶

https://api.sera.cx/api/v1

内容类型¶

所有请求和响应使用 JSON：

Content-Type: application/json

身份验证¶

API 支持两种身份验证方式：

详情请参阅身份验证。

频率限制¶

公网匿名限速由边缘代理/CDN 处理。携带 API Key 的请求会在应用内按钱包地址再做限速：

端点¶

系统¶

交易¶

账户¶

API Key 管理¶

错误响应¶

所有错误返回包含 detail 字段的 JSON 体：

{
  "detail": "Human-readable error message"
}

服务端故障（原 5xx）会统一映射为 503 且响应体改写为通用文案 —— 客户端看到的是 {"detail": "Service temporarily unavailable; please retry"} 与 Retry-After: 1 响应头；具体原因仅记录在服务端日志，不回传给调用方。

状态码¶

代码示例¶

// Public endpoint (no auth)
const tokens = await fetch('https://api.sera.cx/api/v1/tokens')
  .then(r => r.json());

// Authenticated endpoint (API key)
const orders = await fetch('https://api.sera.cx/api/v1/orders?owner_address=0x...', {
  headers: { 'Authorization': 'Bearer sera_abc123:secret456' }
}).then(r => r.json());

import requests

# Public endpoint
tokens = requests.get("https://api.sera.cx/api/v1/tokens").json()

# Authenticated endpoint
headers = {"Authorization": "Bearer sera_abc123:secret456"}
orders = requests.get(
    "https://api.sera.cx/api/v1/orders",
    params={"owner_address": "0x..."},
    headers=headers
).json()

# Public endpoint
curl https://api.sera.cx/api/v1/tokens

# Authenticated endpoint
curl -H "Authorization: Bearer sera_abc123:secret456" \
  "https://api.sera.cx/api/v1/orders?owner_address=0x..."