API 文档
使用账号 API 密钥查询市场目录和原始日期观测数据。
鉴权与访问
通过HTTPS在X-API-Key请求头中传递密钥。网页登录令牌及数据写入密钥不能用作查询密钥。不要将密钥放入网址或公开分享。
暂未开放订阅购买。测试权限由邀请开通,不收取费用。
目录与观测数据
先查询目录,再用返回的标识查询价格或船舶订单。价格查询必填frequency、startDate、endDate;订单查询使用startPeriod、endPeriod,保留原月度或年度格式。
返回值保留原始单位、币种、地区、频率和统计口径,不进行插值、模拟价格或自动汇率换算。
limit为1至1,000,将返回的nextAfter用于下一次请求的after参数,其他筛选不变。分页不重复游标对应记录;空结果不表示价格为零。
用量与错误
通过鉴权并获准执行的查询均计入月请求额度,包括返回错误的查询;返回的目录行和观测值计入记录额度。密钥共享账号额度,每个UTC自然月开始时重置。
HTTP 400表示参数错误,401密钥无效,403权限无效,404无公开数据集,429触发速率、并发或额度限制,503测试未开启。429的Retry-After为60秒,仅为最短等待,不表示月额度已恢复。
数据查询仅支持GET,不执行交易、不提供投资建议,也不暴露账号、草稿或管理记录。
GET /api/v1/datasets?limit=100 GET /api/v1/prices/{id}/observations?frequency=daily&startDate=2026-01-01&endDate=2026-01-31 GET /api/v1/ship-orders/{id}/observations?startPeriod=2025-01&endPeriod=2025-12 X-API-Key: YOUR_API_KEY