CoinPerps API 提供统一接口，可访问来自多个去中心化交易所（DEX）的永续合约数据。
基础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-限制: 允许的最大请求数X-速率限制剩余: 剩余请求X-速率限制重置Unix时间戳（当限制重置时）
响应格式
成功响应：
{
"success": true,
"data": { ... },
"meta": {
"timestamp": 1704067200000,
"cached": false,
"cacheAge": null
}
}
错误响应：
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Human-readable error message"
}
}
支持的交易所
端点
交易所
列出所有交易所
返回所有支持的DEX永续合约交易所列表。
获取交易所
获取交易详情
返回关于特定交易所的详细信息。
获取/交易所/{交易所ID}
股票代码
获取所有股票代码
返回所有交易所中所有交易对的行情数据。
获取/股票代码
按交易所获取股票代码
返回特定交易所的所有股票代码数据。
获取/股票代码/{交易所ID}
获取单个股票代码
返回特定交易对的行情数据。
获取/ticker/{交易所ID}/{股票代码}
示例回复：
{
"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）的永续合约交易提供全面指标。
获取/指标
获取DEX排名
返回按不同指标排序的DEX排名。
获取/指标/排名
获取全面指标
返回所有去中心化交易所（DEX）的汇总总计。
获取/指标/总计
获取音量历史记录
返回历史每日交易量。
获取/指标/体量/历史
获取累计体积
返回随时间推移的累计（滚动总计）交易量。
获取/指标/体量/累计
获取DEX与CEX的比率
返回DEX永续合约交易量与CEX交易量的当前比率。
获取/指标/去中心化交易所与中心化交易所比率
获取去中心化交易所与中心化交易所比率历史数据
返回历史去中心化交易所（DEX）与中心化交易所（CEX）永续合约交易量比率。
获取/指标/场外交易与场内交易比率/历史数据
获取单一交易所指标
返回特定交易所的详细指标。
获取/metrics/{交易所ID}
标志
获取所有交易所徽标
返回所有支持交易所的徽标URL。
获取/标志/交易所
获取Exchange徽标
返回特定交易所的徽标URL。
获取/logos/交易所/{交易所ID}
获取所有硬币徽标
返回所有支持币种的徽标URL。
获取/标志/硬币
获取硬币标志
返回特定代币的徽标URL。
获取/标识/代币/{符号}
图标（替代方案）
获取所有加密货币图标
返回一个映射表，其中加密货币符号对应其图标URL。
获取/股票代码/图标
获取符号图标
返回特定加密货币符号的图标URL。
获取/股票代码/图标/{股票代码}
错误代码
代码示例
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