COINPERPS API提供对多个去中心化交易所（DEXes）的perpetual futures数据的统一访问。要获取访问权限，请注册并获取您的API密钥。
基础URL:
https://api.coinperps.com/api/v1
认证
所有API请求都需要API密钥。请在请求头中包含您的API密钥：
X-API-Key: 您的API密钥
示例：
curl -X GET "https://api.coinperps.com/api/v1/exchanges" \
-H "X-API-Key: cpk_live_your_api_key_here"
速率限制
所有响应中均包含速率限制头：
X-RateLimit-Limit: 允许的最大请求数X-RateLimit-Remaining: 剩余请求数X-RateLimit-Reset: 限制重置时的Unix时间戳
响应格式
成功响应：
{
"success": true,
"data": { ... },
"meta": {
"timestamp": 1704067200000,
"cached": false,
"cacheAge": null
}
}
错误响应：
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Human-readable error message"
}
}
支持的交易所
端点
交易所
列出所有交易所
返回所有支持的DEX perpetual交易所列表。
GET/exchanges
获取交易所详情
返回特定交易所的详细信息。
GET/exchanges/{exchangeId}
行情
获取所有行情数据
返回所有交易所所有交易对的行情数据。
GET/tickers
按交易所获取行情数据
返回特定交易所的所有行情数据。
GET/tickers/{exchangeId}
获取单个行情数据
返回特定交易对的行情数据。
GET/ticker/{exchangeId}/{symbol}
响应示例：
{
"success": true,
"data": {
"exchange": "hyperliquid",
"symbol": "BTC-PERP",
"price": "43250.50",
"indexPrice": "43248.00",
"markPrice": "43250.50",
"bid": "43249.00",
"ask": "43251.00",
"volume24h": "15234.567",
"volumeUsd24h": "658234567.89",
"priceChange24h": "250.50",
"priceChangePercent24h": "0.58",
"openInterest": "5000.25",
"openInterestUsd": "216256343.13",
"fundingRate": "0.0001",
"nextFundingTime": 1704070800000,
"timestamp": 1704067200000,
"iconUrl": "https://static.edgex.exchange/icons/coin/BTC.png"
}
}
指标
获取聚合指标
返回所有DEX perpetual交易所的综合指标。
GET/metrics
获取DEX排名
返回按各种指标排序的DEX排名。
GET/metrics/rankings
获取总计指标
返回所有DEX交易所的汇总总计。
GET/metrics/totals
获取交易量历史数据
返回每日历史交易量。
GET/metrics/volume/history
获取累计交易量
返回随时间变化的累计（滚动总计）交易量。
GET/metrics/volume/cumulative
获取DEX与CEX比率
返回DEX perpetual交易量与CEX交易量的当前比率。
GET/metrics/dex-cex-ratio
获取DEX与CEX比率历史数据
返回DEX与CEX perpetual交易量历史比率。
GET/metrics/dex-cex-ratio/history
获取单一交易所指标
返回特定交易所的详细指标。
GET/metrics/{exchangeId}
徽标
获取所有交易所徽标
返回所有支持的交易所的徽标URL。
GET/logos/exchanges
获取交易所徽标
返回特定交易所的徽标URL。
GET/logos/exchanges/{exchangeId}
获取所有COIN标志
返回所有支持的加密货币的徽标URL。
GET/logos/coins
获取COIN标志
返回特定COIN的标志URL。
GET/logos/coins/{symbol}
图标 (备选)
获取所有加密货币图标
返回加密货币符号与其图标URL的映射。
GET/tickers/icons
获取交易符号图标
返回特定加密货币符号的图标URL。
GET/tickers/icons/{symbol}
错误代码
代码示例
JavaScript / Node.js
const API_KEY = 'cpk_live_your_api_key_here';
const BASE_URL = 'https://api.coinperps.com/api/v1';
async function getMetrics() {
const response = await fetch(`${BASE_URL}/metrics`, {
headers: {
'X-API-Key': API_KEY,
},
});
const data = await response.json();
if (!data.success) {
throw new Error(data.error.message);
}
return data.data;
}
async function getTicker(exchangeId, symbol) {
const response = await fetch(`${BASE_URL}/ticker/${exchangeId}/${symbol}`, {
headers: {
'X-API-Key': API_KEY,
},
});
return response.json();
}
// Usage
getMetrics().then(metrics => {
console.log('Total 24h Volume:', metrics.totalVolume24h);
console.log('Top Exchange:', metrics.exchanges[0].displayName);
});
Python
import requests
API_KEY = 'cpk_live_your_api_key_here'
BASE_URL = 'https://api.coinperps.com/api/v1'
headers = {
'X-API-Key': API_KEY
}
def get_metrics():
response = requests.get(f'{BASE_URL}/metrics', headers=headers)
data = response.json()
if not data['success']:
raise Exception(data['error']['message'])
return data['data']
def get_ticker(exchange_id, symbol):
response = requests.get(
f'{BASE_URL}/ticker/{exchange_id}/{symbol}',
headers=headers
)
return response.json()
# Usage
metrics = get_metrics()
print(f"Total 24h Volume: ${metrics['totalVolume24h']:,.2f}")
print(f"Top Exchange: {metrics['exchanges'][0]['displayName']}")
cURL
# 获取所有指标
curl -X GET "https://api.coinperps.com/api/v1/metrics" \
-H "X-API-Key: cpk_live_your_api_key_here"
# 获取特定交易对
curl -X GET "https://api.coinperps.com/api/v1/ticker/hyperliquid/BTC-PERP" \
-H "X-API-Key: cpk_live_your_api_key_here"
# 获取交易量历史数据
curl -X GET "https://api.coinperps.com/api/v1/metrics/volume/history?startDate=2024-01-01" \
-H "X-API-Key: cpk_live_your_api_key_here"
支持
如有疑问或问题：
- 电子邮件： [email protected]
- 网站： https://coinperps.com