Understanding Token Index Pricing
The index price refers to a currency value derived from aggregated data across multiple third-party sources. This method ensures fair and accurate pricing by minimizing the impact of anomalies on any single exchange.
Key features of token index pricing:
- Multi-source aggregation: Prices reflect a weighted average from leading exchanges
- Real-time updates: Continuously adjusted based on market activity
- Comprehensive coverage: Includes both major tokens and niche assets
Supported Token Types
Our API provides index pricing for diverse digital assets:
- Native tokens (e.g., ETH, BTC, SOL)
- Smart contract tokens (ERC-20, BEP-20, etc.)
Bitcoin inscription tokens:
- BRC-20 standard
- Runes protocol tokens
- ARC-20 and SRC-20 variants
- Fractal Bitcoin chain assets (FBRC-20)
API Technical Specifications
Endpoint Details
👉 Access the full API documentation for complete integration guides.
POST `https://web3.okx.com/api/v5/wallet/token/current-price`Request Parameters Table
| Parameter | Type | Required | Description |
|---|---|---|---|
chainIndex | String | Yes | Blockchain network identifier |
tokenAddress | String | Yes | Contract address (see special cases below) |
Special Address Formats:
- Native tokens:
""(empty string) - BRC-20:
btc-brc20-[tickname](e.g.,btc-brc20-ordi) - Runes:
btc-runesMain-[tickId](e.g.,btc-runesMain-840000:2)
Response Structure
Successful queries return:
- Current
price(string) - Timestamp (
time) in milliseconds - Blockchain identifier (
chainIndex) - Token address verification (
tokenaddress)
Best Practices for Implementation
- Batch Processing: Submit up to 100 tokens per request using array parameters
- Error Handling: Implement retry logic for rate-limited scenarios
- Data Freshness: Cache responses with appropriate expiration (recommend 60s for active trading pairs)
Frequently Asked Questions
What's the difference between index price and market price?
Index prices provide a stabilized benchmark by aggregating multiple sources, while market prices reflect immediate exchange valuations which may contain temporary spreads.
How often are index prices updated?
Our system refreshes prices in real-time, typically with sub-second latency during active market conditions.
Can I query historical price data?
This endpoint only provides current prices. Historical data requires separate endpoints or third-party services.
👉 Explore advanced API features for professional-grade integrations.
Enterprise Use Cases
- Portfolio trackers: Accurate valuation across multiple chains
- DeFi protocols: Reliable oracle data for lending platforms
- Tax solutions: Consistent pricing for compliance reporting
For large-volume requirements or custom implementations, consider our enterprise-grade solutions with enhanced rate limits and dedicated support.