QimenPro API 文檔

QimenPro API 讓你可以程式化存取全市場資金費率和套利機會數據。

概述

Base URL: https://api.qimenpro.ai

格式: JSON

認證: Bearer Token (Pro / Ultra)

方案權限

端點	Free	Pro	Ultra
GET /api/rates	✅ Top 10	✅ Top 10	✅ Top 10
GET /api/arbitrage	✅ Top 5	✅ Top 5	✅ Top 5
GET /api/rates/all	❌	✅ 15 CEX	✅ 全部 (CEX+DEX)
GET /api/rates/history	❌	✅ 30天	✅ 90天
GET /api/arbitrage/all	❌	✅ Top 20	✅ Top 200

Pro 和 Ultra 用戶都可取得 API Token，資料範圍依方案而異。

認證方式

Pro 和 Ultra 用戶可以透過 Telegram Bot 取得 API Token：

開啟 @qimenpro_ai_bot
發送 /apitoken 指令
複製返回的 Token

使用 Token

在 HTTP Header 中添加：

Authorization: Bearer YOUR_TOKEN

⚠️ Token 有效期為 7 天，過期後請重新取得。

API 端點

GET /api/rates

取得即時資金費率（公開端點，限制 Top 10）

回應範例

{
  "statusCode": 200,
  "data": [
    {
      "exchange": "Binance",
      "symbol": "BTCUSDT",
      "rate": 0.0001,
      "nextFundingTime": "2026-01-15T08:00:00Z"
    }
  ]
}

GET /api/rates/all

取得全部即時費率（需 Pro/Ultra）

Query 參數

參數	類型	說明
exchange	string	篩選交易所 (可選)
symbol	string	篩選幣種 (可選)

GET /api/arbitrage

取得套利機會（公開端點，限制 Top 5）

回應範例

{
  "statusCode": 200,
  "data": [
    {
      "symbol": "BTCUSDT",
      "longExchange": "OKX",
      "shortExchange": "Binance",
      "spread": "0.0523",
      "annualYield": "57.27"
    }
  ]
}

GET /api/rates/history

取得歷史費率（需 Pro/Ultra）

Query 參數

參數	類型	說明
symbol	string	幣種 (必填)
exchange	string	交易所 (可選)
days	number	天數 (預設 7，最大 90)

GET /api/rates/exchanges

取得支援的交易所列表（公開）

程式碼範例

Python

import requests

API_URL = "https://api.qimenpro.ai"
TOKEN = "your_token_here"

headers = {"Authorization": f"Bearer {TOKEN}"}

# 取得全部費率
response = requests.get(f"{API_URL}/api/rates/all", headers=headers)
rates = response.json()["data"]

# 找出最大套利機會
for rate in rates:
    print(f"{rate['exchange']}: {rate['symbol']} = {rate['rate']}")

JavaScript / Node.js

const API_URL = "https://api.qimenpro.ai";
const TOKEN = "your_token_here";

async function getRates() {
  const response = await fetch(`${API_URL}/api/rates/all`, {
    headers: { Authorization: `Bearer ${TOKEN}` }
  });
  const { data } = await response.json();
  return data;
}

// 取得套利機會
async function getArbitrage() {
  const response = await fetch(`${API_URL}/api/arbitrage`);
  const { data } = await response.json();
  data.forEach(opp => {
    console.log(`${opp.symbol}: ${opp.annualYield}% APR`);
  });
}

cURL

# 公開端點 (不需 Token)
curl https://api.qimenpro.ai/api/rates

# Pro 端點 (需 Token)
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.qimenpro.ai/api/rates/all

錯誤處理

狀態碼	說明
200	成功
401	未授權 - Token 無效或過期
403	禁止 - 方案權限不足
404	找不到資源
429	請求過多 - 請稍後重試
500	伺服器錯誤

錯誤回應格式

{
  "statusCode": 401,
  "message": "Unauthorized",
  "error": "Token 已過期，請重新取得"
}

支援

如有問題，請透過 Telegram Bot 聯繫我們：

聯繫支援