環境と一般的な慣習

サービスエンドポイント

時間と数値

• 特に指定がない限り、タイムフィールドはUnixのミリ秒タイムスタンプです。
• 日々の統計、バランススナップショット、取引量統計はデフォルトで日 UTC 境界を使用しています。
• 量、価格、数量、レートなどの精度に敏感なフィールドは文字列として送信されます。
• orderId、 conditionId、 strategyId のような大きな整数IDは JSONの文字列として返されます。

応答フォーマット

成功した対応:

1
{
2
  "code": 0,
3
  "message": "success",
4
  "data": {},
5
  "requestId": "req-12345678"
6
}

エラー応答:

1
{
2
  "code": 1003,
3
  "message": "Invalid token",
4
  "requestId": "req-12345678"
5
}

注記:

• ビジネスエラーは通常、統一された JSON 構造を返します。インテグレーターはまずこの code を確認するべきです。
• 認証失敗は HTTP 401を返すことがあります;レートリミットは HTTP 429を返すことがあります。
• リクエストヘッダーで X-Request-ID を送信できます。サーバーは応答で requestId として返します。

関連文書

• 認証: JWT か API Key 署名かを選べ。
• リクエスト署名署名されたリクエストを構成し検証します。
• REST APIこれらの慣習をエンドポイント群に適用します。
• エラーコードとトラブルシューティングHTTPやビジネス上の誤りを診断する。