API

API Operation Key Points

API Types and Permissions

Account API: Binds to a single account, supports read permissions by default, and requires manual activation of trading/transfer permissions (requires IP binding).

Member API: Operates on all accounts under a member, suitable for multi-account management (e.g., portfolio orders). Target accounts must be specified via parameters.

API Creation Process

Steps: Log in to the backend → Select an account/member → Set permissions (read/trade/transfer) → Bind an IP (trading permissions required) → Generate API key and secret key.

IP Whitelist: Each key can be bound to up to 20 IP addresses. Unbound keys with trading and transfer permissions will automatically expire after 90 days of inactivity.

Function Coverage

Supported operations: Deposits, withdrawals, fund transfers, spot/contract/options trading, wealth management, portfolio margin management, etc. (aligned with the web version).

Features:

Market Maker Interface: Pre-freeze funds, skip real-time verification, and increase order speed (higher rate limit, default 500/second)

WS Breakpoint Protection: Automatically cancel orders upon connection loss (default 120 seconds, customizable in the future).

Event ID Increment: Prevents data loss and inconsistent state caused by WebSocket pushes.

Rate Limiting Rules

Default rate limit: 50/second (subject to increase).

Market APIs are rate-limited by IP address, while trading APIs are rate-limited by API key.

Other

Data Query: Default retention is 3 months, with support for longer history (3 years) in the future.

Withdrawal Restrictions: Withdrawal requests can be initiated via the API, but are subject to backend review (same as the web version).

Documentation and SDK: Complete API documentation is provided, and the SDK is expected to be launched by the end of May.