Interface Type

Interface Type

Dipcoin Perpetual API provides two types of interfaces:

Public Interfaces

Public interfaces do not require authentication and can be accessed directly.

Features

• No JWT Token required
• No wallet address required
• Mainly used for obtaining market data

Examples

• Get trading pair list
• Get Ticker information
• Get order book
• Get K-line data

Private Interfaces

Private interfaces require authentication and must carry JWT Token and wallet address.

Features

• Requires JWT Token (in Authorization request header)
• Requires wallet address (in X-Wallet-Address request header)
• Mainly used for trading and account-related operations

Examples

• Place order
• Cancel order
• Query orders
• Query positions
• Query account information

Interface Classification

Authentication Service (Gateway)

• /api/authorize - Public interface (for obtaining Token)

Market Data Service (Market API)

• /api/perp-market-api/* - Mostly public interfaces

Trading Service (Trade API)

• /api/perp-trade-api/trade/public/* - Public interfaces
• /api/perp-trade-api/trade/* - Private interfaces
• /api/perp-trade-api/curr-info/* - Private interfaces
• /api/perp-trade-api/history/* - Private interfaces
• /api/perp-trade-api/user-config/* - Private interfaces
• /api/perp-trade-api/account/* - Private interfaces

Request Frequency Limits

Request Frequency Limits

• Public interfaces: Recommended no more than 3 times per second
• Private interfaces: Recommended no more than 10 times per second
• Exceeding frequency limits may result in request rejection