API 文檔 - AlphaX

HTTP	說明
`400`	請求無效或交易所不支持該能力
`401`	密鑰缺失、無效或已撤銷
`404`	未知交易所或查詢資源
`422`	參數無效
`429`	調用超限，請按 Retry-After 等待
`502 / 503 / 504`	上游或依賴服務暫時不可用。

市場

交易所

返回已配置的交易所、數據源別名及現貨／合約能力；數量不可用時可能為 null。

GET/api/v1/exchanges

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數	類型	說明
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · ExchangeList

欄位	類型	說明
`data`	`Exchange[]`	標準化查詢結果；列表始終為陣列。
`data[].data_source`	`string`	—
`data[].futures_count`	`integer \| null`	已報告的合約標的數量，不可用時為 null。
`data[].has_futures`	`boolean`	—
`data[].has_spot`	`boolean`	—
`data[].id`	`string`	—
`data[].market_data_source`	`string`	—
`data[].name`	`string`	—
`data[].spot_count`	`integer \| null`	已報告的現貨標的數量，不可用時為 null。
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.total`	`integer`	匹配記錄總數。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/exchanges' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/exchanges",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/exchanges",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": [
    {
      "data_source": "",
      "futures_count": 1,
      "has_futures": true,
      "has_spot": true,
      "id": "binance",
      "market_data_source": "binance",
      "name": "Binance",
      "spot_count": 1
    }
  ],
  "error": null,
  "meta": {
    "total": 1
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

市場

分頁查詢行情，默認 Binance 現貨。交易所 ID 從 /exchanges 獲取；股票數據通過 /stocks 查詢。

GET/api/v1/markets

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數	類型	說明
`exchange`可選	`string`	已配置的交易所 ID，默認 binance。
`market`可選	`string`	市場類型，默認 spot。允許值: `spot, futures`
`q`可選	`string`	搜索內容，最多 80 個字符。 `maxLength: 80`
`page`可選	`integer`	頁碼。默認值: `1` `minimum: 1 · maximum: 10000`
`limit`可選	`integer`	每頁條數。默認值: `80` `minimum: 1 · maximum: 200`
`sort`可選	`string`	排序字段，默認 volume。允許值: `symbol, price, change, high, low, volume`
`dir`可選	`string`	排序方向。允許值: `asc, desc`
`symbol`可選	`string`	精確交易標識，例如 BTC-USDT 或 AAPL。不區分大小寫；系統在內部映射交易所原始標識。不能與 symbols 或 q 同時使用。
`symbols`可選	`string`	逗號分隔的精確交易標識，最多 30 個。不能與 symbol 或 q 同時使用。先匹配再分頁；股票在一頁內返回所請求的結果。
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · MarketPage

欄位	類型	說明
`data`	`Ticker[]`	標準化查詢結果；列表始終為陣列。
`data[].base`	`string`	基礎資產代碼。
`data[].change_24h`	`number`	價格漲跌百分數，請同時檢查 change_period 統計週期。
`data[].change_period`	`string`	—
`data[].exchange`	`string`	交易所或獨立數據源 ID。
`data[].high_24h`	`number`	—
`data[].low_24h`	`number`	—
`data[].market_type`	`string`	—
`data[].price`	`number`	以報價幣計價的觀測價格。
`data[].quote`	`string`	報價幣種代碼。
`data[].range_period`	`string`	—
`data[].symbol`	`string`	站內規範化標的標識。
`data[].updated_at`	`integer`	觀測時間，單位為 Unix 秒。
`data[].volume_24h`	`number`	以報價幣為單位的成交量，請同時檢查可用性和估算標記。
`data[].volume_estimated`	`boolean`	—
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.counts`	`object`	—
`meta.exchange`	`string`	—
`meta.market_type`	`string`	—
`meta.pagination`	`Pagination`	分頁元數據及指向本 API 的翻頁鏈接。
`meta.pagination.end`	`integer`	—
`meta.pagination.limit`	`integer`	—
`meta.pagination.next_url`	`string`	下一頁 API 地址，沒有下一頁時為空字符串。
`meta.pagination.page`	`integer`	當前頁碼，從 1 開始。
`meta.pagination.previous_url`	`string`	上一頁 API 地址，沒有上一頁時為空字符串。
`meta.pagination.start`	`integer`	—
`meta.pagination.total`	`integer`	匹配記錄總數。
`meta.pagination.total_pages`	`integer`	總頁數。
`meta.query`	`string`	—
`meta.source`	`string`	—
`meta.total`	`integer`	—
`meta.updated_at`	`integer`	觀測時間，單位為 Unix 秒。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/markets?exchange=binance&limit=2&market=spot&symbol=BTC-USDT' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/markets?exchange=binance\u0026limit=2\u0026market=spot\u0026symbol=BTC-USDT",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/markets?exchange=binance\u0026limit=2\u0026market=spot\u0026symbol=BTC-USDT",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": [
    {
      "base": "BTC",
      "change_24h": 0.75,
      "change_period": "",
      "exchange": "binance",
      "high_24h": 110,
      "low_24h": 90,
      "market_type": "spot",
      "price": 100,
      "quote": "USDT",
      "range_period": "",
      "symbol": "BTC-USDT",
      "updated_at": 1794614400,
      "volume_24h": 100,
      "volume_estimated": false
    }
  ],
  "error": null,
  "meta": {
    "counts": {
      "futures": 0,
      "matched": 1,
      "spot": 1
    },
    "exchange": "binance",
    "market_type": "spot",
    "pagination": {
      "end": 1,
      "limit": 2,
      "next_url": "",
      "page": 1,
      "previous_url": "",
      "start": 1,
      "total": 1,
      "total_pages": 1
    },
    "query": "",
    "total": 1,
    "updated_at": 1794614400
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

市場

現貨行情

返回指定交易所的現貨行情快照，請同時通過 /market-status 檢查數據源健康狀態和時間。

GET/api/v1/tickers/{exchange}/spot

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

路徑參數

參數	類型	說明
`exchange`必填	`string`	已配置的交易所 ID。

查詢參數

參數	類型	說明
`symbol`可選	`string`	精確交易標識，例如 BTC-USDT 或 AAPL。不區分大小寫；系統在內部映射交易所原始標識。不能與 symbols 或 q 同時使用。
`symbols`可選	`string`	逗號分隔的精確交易標識，最多 30 個。不能與 symbol 或 q 同時使用。先匹配再分頁；股票在一頁內返回所請求的結果。
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · TickerArray

欄位	類型	說明
`data`	`Ticker[]`	標準化查詢結果；列表始終為陣列。
`data[].base`	`string`	基礎資產代碼。
`data[].change_24h`	`number`	價格漲跌百分數，請同時檢查 change_period 統計週期。
`data[].change_period`	`string`	—
`data[].exchange`	`string`	交易所或獨立數據源 ID。
`data[].high_24h`	`number`	—
`data[].low_24h`	`number`	—
`data[].market_type`	`string`	—
`data[].price`	`number`	以報價幣計價的觀測價格。
`data[].quote`	`string`	報價幣種代碼。
`data[].range_period`	`string`	—
`data[].symbol`	`string`	站內規範化標的標識。
`data[].updated_at`	`integer`	觀測時間，單位為 Unix 秒。
`data[].volume_24h`	`number`	以報價幣為單位的成交量，請同時檢查可用性和估算標記。
`data[].volume_estimated`	`boolean`	—
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.exchange`	`string`	—
`meta.total`	`integer`	—

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/tickers/binance/spot?symbol=BTC-USDT' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/tickers/binance/spot?symbol=BTC-USDT",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/tickers/binance/spot?symbol=BTC-USDT",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": [
    {
      "base": "BTC",
      "change_24h": 0.75,
      "change_period": "",
      "exchange": "binance",
      "high_24h": 110,
      "low_24h": 90,
      "market_type": "spot",
      "price": 100,
      "quote": "USDT",
      "range_period": "",
      "symbol": "BTC-USDT",
      "updated_at": 1794614400,
      "volume_24h": 100,
      "volume_estimated": false
    }
  ],
  "error": null,
  "meta": {
    "exchange": "binance",
    "total": 1
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

市場

合約行情

返回指定交易所的合約行情快照，請同時通過 /market-status 檢查數據源健康狀態和時間。

GET/api/v1/tickers/{exchange}/futures

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

路徑參數

參數	類型	說明
`exchange`必填	`string`	已配置的交易所 ID。

查詢參數

參數	類型	說明
`symbol`可選	`string`	精確交易標識，例如 BTC-USDT 或 AAPL。不區分大小寫；系統在內部映射交易所原始標識。不能與 symbols 或 q 同時使用。
`symbols`可選	`string`	逗號分隔的精確交易標識，最多 30 個。不能與 symbol 或 q 同時使用。先匹配再分頁；股票在一頁內返回所請求的結果。
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · TickerArray

欄位	類型	說明
`data`	`Ticker[]`	標準化查詢結果；列表始終為陣列。
`data[].base`	`string`	基礎資產代碼。
`data[].change_24h`	`number`	價格漲跌百分數，請同時檢查 change_period 統計週期。
`data[].change_period`	`string`	—
`data[].exchange`	`string`	交易所或獨立數據源 ID。
`data[].high_24h`	`number`	—
`data[].low_24h`	`number`	—
`data[].market_type`	`string`	—
`data[].price`	`number`	以報價幣計價的觀測價格。
`data[].quote`	`string`	報價幣種代碼。
`data[].range_period`	`string`	—
`data[].symbol`	`string`	站內規範化標的標識。
`data[].updated_at`	`integer`	觀測時間，單位為 Unix 秒。
`data[].volume_24h`	`number`	以報價幣為單位的成交量，請同時檢查可用性和估算標記。
`data[].volume_estimated`	`boolean`	—
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.exchange`	`string`	—
`meta.total`	`integer`	—

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/tickers/binance/futures?symbol=BTC-USDT' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/tickers/binance/futures?symbol=BTC-USDT",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/tickers/binance/futures?symbol=BTC-USDT",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": [
    {
      "base": "BTC",
      "change_24h": 0.75,
      "change_period": "",
      "exchange": "binance",
      "high_24h": 110,
      "low_24h": 90,
      "market_type": "futures",
      "price": 100,
      "quote": "USDT",
      "range_period": "",
      "symbol": "BTC-USDT",
      "updated_at": 1794614400,
      "volume_24h": 100,
      "volume_estimated": false
    }
  ],
  "error": null,
  "meta": {
    "exchange": "binance",
    "total": 1
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

市場

資金費率

分頁查詢合約資金費率，每頁 80 條。費率使用百分數，next_funding_time 為 Unix 秒。

GET/api/v1/funding-rates

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數	類型	說明
`source`可選	`string`	獨立合約數據源 ID，或 all（默認）。
`q`可選	`string`	搜索內容，最多 80 個字符。 `maxLength: 80`
`page`可選	`integer`	頁碼。默認值: `1` `minimum: 1 · maximum: 10000`
`sort`可選	`string`	排序字段，默認 abs_rate。允許值: `abs_rate, rate, annualized, symbol, exchange, mark, index, interval, next`
`dir`可選	`string`	排序方向，默認 desc。允許值: `asc, desc`
`symbol`可選	`string`	精確交易標識，例如 BTC-USDT 或 AAPL。不區分大小寫；系統在內部映射交易所原始標識。不能與 symbols 或 q 同時使用。
`symbols`可選	`string`	逗號分隔的精確交易標識，最多 30 個。不能與 symbol 或 q 同時使用。先匹配再分頁；股票在一頁內返回所請求的結果。
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · FundingPage

欄位	類型	說明
`data`	`FundingRate[]`	標準化查詢結果；列表始終為陣列。
`data[].base`	`string`	基礎資產代碼。
`data[].exchange`	`string`	交易所或獨立數據源 ID。
`data[].funding_interval_hours`	`integer`	資金費率結算間隔，單位為小時。
`data[].funding_rate`	`number`	資金費率百分數：0.01 表示 0.01%。
`data[].funding_rate_annualized`	`number`	—
`data[].index_price`	`number`	—
`data[].mark_price`	`number`	—
`data[].next_funding_time`	`integer`	下一次資金費率結算時間，單位為 Unix 秒。
`data[].quote`	`string`	報價幣種代碼。
`data[].symbol`	`string`	站內規範化標的標識。
`data[].updated_at`	`integer`	觀測時間，單位為 Unix 秒。
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.all_total`	`integer`	—
`meta.pagination`	`Pagination`	分頁元數據及指向本 API 的翻頁鏈接。
`meta.pagination.end`	`integer`	—
`meta.pagination.limit`	`integer`	—
`meta.pagination.next_url`	`string`	下一頁 API 地址，沒有下一頁時為空字符串。
`meta.pagination.page`	`integer`	當前頁碼，從 1 開始。
`meta.pagination.previous_url`	`string`	上一頁 API 地址，沒有上一頁時為空字符串。
`meta.pagination.start`	`integer`	—
`meta.pagination.total`	`integer`	匹配記錄總數。
`meta.pagination.total_pages`	`integer`	總頁數。
`meta.query`	`string`	—
`meta.source`	`string`	媒體或查詢數據提供方的名稱。
`meta.source_counts`	`object`	—
`meta.total`	`integer`	匹配記錄總數。
`meta.updated_at`	`integer`	觀測時間，單位為 Unix 秒。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/funding-rates?source=binance&symbol=BTC-USDT' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/funding-rates?source=binance\u0026symbol=BTC-USDT",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/funding-rates?source=binance\u0026symbol=BTC-USDT",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": [
    {
      "base": "BTC",
      "exchange": "binance",
      "funding_interval_hours": 8,
      "funding_rate": -0.01,
      "funding_rate_annualized": -10.95,
      "index_price": 100,
      "mark_price": 100,
      "next_funding_time": 1794643200,
      "quote": "USDT",
      "symbol": "BTC-USDT",
      "updated_at": 1794614400
    }
  ],
  "error": null,
  "meta": {
    "pagination": {
      "end": 1,
      "limit": 80,
      "next_url": "",
      "page": 1,
      "previous_url": "",
      "start": 1,
      "total": 1,
      "total_pages": 1
    },
    "source": "binance",
    "total": 1,
    "updated_at": 1794614400
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

市場

交易所資金費率

返回完整資金費率快照，包含數據源狀態和 generated_at 時間。

GET/api/v1/funding-rates/{exchange}

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

路徑參數

參數	類型	說明
`exchange`必填	`string`	支持合約的交易所 ID。

查詢參數

參數	類型	說明
`symbol`可選	`string`	精確交易標識，例如 BTC-USDT 或 AAPL。不區分大小寫；系統在內部映射交易所原始標識。不能與 symbols 或 q 同時使用。
`symbols`可選	`string`	逗號分隔的精確交易標識，最多 30 個。不能與 symbol 或 q 同時使用。先匹配再分頁；股票在一頁內返回所請求的結果。
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · FundingSnapshot

欄位	類型	說明
`data`	`FundingRate[]`	標準化查詢結果；列表始終為陣列。
`data[].base`	`string`	基礎資產代碼。
`data[].exchange`	`string`	交易所或獨立數據源 ID。
`data[].funding_interval_hours`	`integer`	資金費率結算間隔，單位為小時。
`data[].funding_rate`	`number`	資金費率百分數：0.01 表示 0.01%。
`data[].funding_rate_annualized`	`number`	—
`data[].index_price`	`number`	—
`data[].mark_price`	`number`	—
`data[].next_funding_time`	`integer`	下一次資金費率結算時間，單位為 Unix 秒。
`data[].quote`	`string`	報價幣種代碼。
`data[].symbol`	`string`	站內規範化標的標識。
`data[].updated_at`	`integer`	觀測時間，單位為 Unix 秒。
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.exchange`	`string`	交易所或獨立數據源 ID。
`meta.status`	`FeedStatus`	數據源或服務狀態；HTTP 成功不代表上游健康。
`meta.status.error`	`string`	錯誤標識或診斷摘要。
`meta.status.last_success_at`	`integer`	—
`meta.status.ok`	`boolean`	該數據源是否健康。
`meta.status.updated_at`	`integer`	觀測時間，單位為 Unix 秒。
`meta.total`	`integer`	—
`meta.updated_at`	`integer`	快照生成時間，單位為 Unix 秒。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/funding-rates/binance?symbol=BTC-USDT' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/funding-rates/binance?symbol=BTC-USDT",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/funding-rates/binance?symbol=BTC-USDT",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": [
    {
      "base": "BTC",
      "exchange": "binance",
      "funding_interval_hours": 8,
      "funding_rate": -0.01,
      "funding_rate_annualized": -10.95,
      "index_price": 100,
      "mark_price": 100,
      "next_funding_time": 1794643200,
      "quote": "USDT",
      "symbol": "BTC-USDT",
      "updated_at": 1794614400
    }
  ],
  "error": null,
  "meta": {
    "exchange": "binance",
    "status": {
      "error": "",
      "last_success_at": 1794614400,
      "ok": true,
      "updated_at": 1794614400
    },
    "total": 1,
    "updated_at": 1794614400
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

市場

未平倉量

查詢支持數據源的未平倉量榜單，默認 binance；單位和可用來源與本站未平倉量頁面一致。

GET/api/v1/open-interest

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數	類型	說明
`source`可選	`string`	支持未平倉量的數據源 ID，響應的 source_ids 提供可用列表。
`q`可選	`string`	搜索內容，最多 80 個字符。 `maxLength: 80`
`page`可選	`integer`	頁碼。默認值: `1` `minimum: 1 · maximum: 10000`
`limit`可選	`integer`	每頁條數。默認值: `80` `minimum: 1 · maximum: 80`
`sort`可選	`string`	排序字段，默認 oi。允許值: `symbol, oi, change, exchange, volume, price`
`dir`可選	`string`	排序方向，默認 desc。允許值: `asc, desc`
`symbol`可選	`string`	精確交易標識，例如 BTC-USDT 或 AAPL。不區分大小寫；系統在內部映射交易所原始標識。不能與 symbols 或 q 同時使用。
`symbols`可選	`string`	逗號分隔的精確交易標識，最多 30 個。不能與 symbol 或 q 同時使用。先匹配再分頁；股票在一頁內返回所請求的結果。
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · OpenInterestPage

欄位	類型	說明
`data`	`OpenInterest[]`	標準化查詢結果；列表始終為陣列。
`data[].base`	`string`	基礎資產代碼。
`data[].change_24h`	`number`	—
`data[].change_period`	`string`	—
`data[].exchange`	`string`	交易所或獨立數據源 ID。
`data[].open_interest`	`number`	以基礎資產數量計的未平倉量。
`data[].open_interest_change_pct`	`number \| null`	變化百分數，沒有可比觀測時為 null。
`data[].open_interest_value`	`number`	以報價幣計的未平倉量價值。
`data[].price`	`number`	以報價幣計價的觀測價格。
`data[].quote`	`string`	報價幣種代碼。
`data[].symbol`	`string`	站內規範化標的標識。
`data[].timestamp`	`integer`	觀測時間，單位為 Unix 秒。
`data[].volume_24h`	`number`	—
`data[].volume_estimated`	`boolean`	—
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.all_total`	`integer`	—
`meta.pagination`	`Pagination`	分頁元數據及指向本 API 的翻頁鏈接。
`meta.pagination.end`	`integer`	—
`meta.pagination.limit`	`integer`	—
`meta.pagination.next_url`	`string`	下一頁 API 地址，沒有下一頁時為空字符串。
`meta.pagination.page`	`integer`	當前頁碼，從 1 開始。
`meta.pagination.previous_url`	`string`	上一頁 API 地址，沒有上一頁時為空字符串。
`meta.pagination.start`	`integer`	—
`meta.pagination.total`	`integer`	匹配記錄總數。
`meta.pagination.total_pages`	`integer`	總頁數。
`meta.query`	`string`	—
`meta.source`	`string`	媒體或查詢數據提供方的名稱。
`meta.source_counts`	`object`	—
`meta.source_ids`	`string[]`	—
`meta.total`	`integer`	匹配記錄總數。
`meta.updated_at`	`integer`	觀測時間，單位為 Unix 秒。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/open-interest?source=binance&symbol=BTC-USDT' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/open-interest?source=binance\u0026symbol=BTC-USDT",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/open-interest?source=binance\u0026symbol=BTC-USDT",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": [
    {
      "base": "BTC",
      "change_24h": 0.75,
      "change_period": "",
      "exchange": "binance",
      "open_interest": 1200,
      "open_interest_change_pct": null,
      "open_interest_value": 120000,
      "price": 100,
      "quote": "USDT",
      "symbol": "BTC-USDT",
      "timestamp": 1794614400,
      "volume_24h": 100,
      "volume_estimated": false
    }
  ],
  "error": null,
  "meta": {
    "pagination": {
      "end": 1,
      "limit": 80,
      "next_url": "",
      "page": 1,
      "previous_url": "",
      "start": 1,
      "total": 1,
      "total_pages": 1
    },
    "source": "binance",
    "source_ids": [
      "binance"
    ],
    "total": 1,
    "updated_at": 1794614400
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

市場

股票

Binance 股票行情及資料可用標記。分頁資訊位於 meta.pagination；精確標識查詢在一頁內返回結果。

GET/api/v1/stocks

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數	類型	說明
`q`可選	`string`	搜索內容，最多 80 個字符。 `maxLength: 80`
`region`可選	`string`	地區，默認 all。允許值: `all, us`
`universe`可選	`string`	股票範圍，默認 all。允許值: `all, tokenized`
`page`可選	`integer`	頁碼。默認值: `1` `minimum: 1 · maximum: 10000`
`limit`可選	`integer`	每頁條數。默認值: `80` `minimum: 1 · maximum: 200`
`sort`可選	`string`	排序字段。允許值: `symbol, price, change, high, low, volume`
`dir`可選	`string`	排序方向。允許值: `asc, desc`
`symbol`可選	`string`	精確交易標識，例如 BTC-USDT 或 AAPL。不區分大小寫；系統在內部映射交易所原始標識。不能與 symbols 或 q 同時使用。
`symbols`可選	`string`	逗號分隔的精確交易標識，最多 30 個。不能與 symbol 或 q 同時使用。先匹配再分頁；股票在一頁內返回所請求的結果。
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · StockArray

欄位	類型	說明
`data`	`object[]`	標準化查詢結果；列表始終為陣列。
`data[].asset_code`	`string \| null`	—
`data[].asset_name`	`string \| null`	—
`data[].base`	`string \| null`	—
`data[].change_24h`	`number \| null`	—
`data[].change_available`	`boolean`	—
`data[].data_stale`	`boolean`	該觀測數據是否已過期。
`data[].data_timestamp`	`integer \| null`	—
`data[].exchange`	`string \| null`	—
`data[].high_24h`	`number \| null`	—
`data[].low_24h`	`number \| null`	—
`data[].market_phase`	`string \| null`	—
`data[].market_type`	`string`	—
`data[].name`	`string \| null`	—
`data[].price`	`number \| null`	—
`data[].price_available`	`boolean`	是否存在可用的觀測價格。
`data[].quote`	`string \| null`	—
`data[].stock_market`	`string`	—
`data[].symbol`	`string`	站內規範化標的標識。
`data[].tradability`	`string \| null`	—
`data[].trading_status`	`string`	—
`data[].volume_24h`	`number \| null`	—
`data[].volume_available`	`boolean`	—
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.pagination`	`Pagination`	—
`meta.pagination.end`	`integer`	—
`meta.pagination.limit`	`integer`	—
`meta.pagination.next_url`	`string`	下一頁 API 地址，沒有下一頁時為空字符串。
`meta.pagination.page`	`integer`	當前頁碼，從 1 開始。
`meta.pagination.previous_url`	`string`	上一頁 API 地址，沒有上一頁時為空字符串。
`meta.pagination.start`	`integer`	—
`meta.pagination.total`	`integer`	匹配記錄總數。
`meta.pagination.total_pages`	`integer`	總頁數。
`meta.total`	`integer`	—

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/stocks?symbols=AAPL' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/stocks?symbols=AAPL",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/stocks?symbols=AAPL",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": [
    {
      "asset_code": null,
      "asset_name": null,
      "base": null,
      "change_24h": 1.01,
      "change_available": true,
      "data_stale": false,
      "data_timestamp": null,
      "exchange": null,
      "high_24h": null,
      "low_24h": null,
      "market_phase": null,
      "market_type": "stock",
      "name": null,
      "price": 100.05,
      "price_available": true,
      "quote": null,
      "stock_market": "us",
      "symbol": "AAPL",
      "tradability": null,
      "trading_status": "TRADING",
      "volume_24h": 1000000,
      "volume_available": true
    }
  ],
  "error": null,
  "meta": {
    "pagination": {
      "end": 1,
      "limit": 1,
      "next_url": "",
      "page": 1,
      "previous_url": "",
      "start": 1,
      "total": 1,
      "total_pages": 1
    },
    "total": 1
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

市場

行情數據狀態

返回各數據源的健康狀態、數量和最後成功時間。HTTP 請求成功不代表上游數據源健康。

GET/api/v1/market-status

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數	類型	說明
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · MarketStatus

欄位	類型	說明
`data`	`object`	標準化查詢結果；列表始終為陣列。
`data.degraded_feeds`	`string[]`	—
`data.exchanges`	`object[]`	—
`data.exchanges[].counts`	`object`	—
`data.exchanges[].exchange`	`string`	交易所或獨立數據源 ID。
`data.exchanges[].generated_at`	`integer`	快照生成時間，單位為 Unix 秒。
`data.exchanges[].status`	`object`	數據源或服務狀態；HTTP 成功不代表上游健康。
`data.status`	`string`	數據源或服務狀態；HTTP 成功不代表上游健康。
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/market-status' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/market-status",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/market-status",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": {
    "degraded_feeds": [],
    "exchanges": [
      {
        "counts": {
          "futures": 1,
          "spot": 1
        },
        "exchange": "binance",
        "generated_at": 1794614400,
        "status": {
          "spot": {
            "error": "",
            "last_success_at": 1794614400,
            "ok": true,
            "updated_at": 1794614400
          }
        }
      }
    ],
    "status": "ok"
  },
  "error": null,
  "meta": {}
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

新聞

查詢原始發佈時間位於最近 72 小時的新聞，按時間倒序並按原文 URL 去重。語言篩選僅選擇對應原文，不翻譯文章；省略 language 時返回所有可用語言。

GET/api/v1/news

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數	類型	說明
`language`可選	`string`	文章語言：en、zh-CN、zh-TW、es、de、ja、fr、all 或 auto；auto 跟隨 locale，兼容中文語言別名。
`source`可選	`string`	新聞響應 sources 中的媒體顯示名稱。
`asset`可選	`string`	資產標識，例如 BTC。
`q`可選	`string`	搜索內容，最多 80 個字符。 `maxLength: 80`
`page`可選	`integer`	頁碼。默認值: `1` `minimum: 1 · maximum: 10000`
`limit`可選	`integer`	每頁文章數。默認值: `24` `minimum: 1 · maximum: 50`
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · NewsPage

欄位	類型	說明
`data`	`Article[]`	標準化查詢結果；列表始終為陣列。
`data[].archived_iso`	`string`	—
`data[].assets`	`string[]`	—
`data[].description`	`string`	—
`data[].detail_url`	`string`	—
`data[].language`	`string`	文章原文語言，不進行翻譯。
`data[].published_iso`	`string`	原始發佈時間，格式為 ISO 8601。
`data[].slug`	`string`	—
`data[].source`	`string`	媒體或查詢數據提供方的名稱。
`data[].title`	`string`	—
`data[].url`	`string`	原始媒體鏈接。
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.asset`	`string`	—
`meta.language`	`string`	文章原文語言，不進行翻譯。
`meta.language_filters`	`object[]`	—
`meta.language_filters[].code`	`string`	—
`meta.language_filters[].label_key`	`string`	—
`meta.limit`	`integer`	—
`meta.pagination`	`Pagination`	分頁元數據及指向本 API 的翻頁鏈接。
`meta.pagination.end`	`integer`	—
`meta.pagination.limit`	`integer`	—
`meta.pagination.next_url`	`string`	下一頁 API 地址，沒有下一頁時為空字符串。
`meta.pagination.page`	`integer`	當前頁碼，從 1 開始。
`meta.pagination.previous_url`	`string`	上一頁 API 地址，沒有上一頁時為空字符串。
`meta.pagination.start`	`integer`	—
`meta.pagination.total`	`integer`	匹配記錄總數。
`meta.pagination.total_pages`	`integer`	總頁數。
`meta.query`	`string`	—
`meta.source`	`string`	媒體或查詢數據提供方的名稱。
`meta.sources`	`string[]`	—
`meta.total`	`integer`	匹配記錄總數。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/news?language=en&limit=2' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/news?language=en\u0026limit=2",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/news?language=en\u0026limit=2",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": [
    {
      "archived_iso": "2026-11-14T00:00:00Z",
      "assets": [
        "BTC"
      ],
      "description": "An illustrative news summary.",
      "detail_url": "/news/example-story",
      "language": "en",
      "published_iso": "2026-11-14T00:00:00Z",
      "slug": "example-story",
      "source": "Example publisher",
      "title": "Example market news",
      "url": "https://example.com/news"
    }
  ],
  "error": null,
  "meta": {
    "language": "en",
    "limit": 2,
    "pagination": {
      "end": 1,
      "limit": 2,
      "next_url": "",
      "page": 1,
      "previous_url": "",
      "start": 1,
      "total": 1,
      "total_pages": 1
    },
    "sources": [
      "Example publisher"
    ],
    "total": 1
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

工具箱

IP 查詢

省略 ip 時查詢調用方的公網 IP，僅信任來自迴環地址反向代理的轉發 IP。內網及保留地址返回 422，本機調用需顯式傳入公網 IP。

GET/api/v1/tools/ip

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數	類型	說明
`ip`可選	`string`	可選的公網 IPv4 或 IPv6；省略或留空時查詢調用方 IP。
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · IPResult

欄位	類型	說明
`data`	`object`	標準化查詢結果；列表始終為陣列。
`data.as_domain`	`string`	自治系統域名，僅在數據提供方返回時存在。
`data.asn`	`string`	自治系統編號，僅在數據提供方返回時存在。
`data.city`	`string`	數據提供方報告的城市，有數據時返回。
`data.country`	`string`	國家名稱，僅在數據提供方返回時存在。
`data.country_code`	`string`	數據提供方報告的兩位國家代碼。
`data.hostname`	`string`	報告的主機名，有數據時返回。
`data.ip`	`string`	規範化的公網 IPv4 或 IPv6 地址。
`data.location`	`string`	報告的經緯度，有數據時返回。
`data.organization`	`string`	網絡組織名稱，僅在數據提供方返回時存在。
`data.region`	`string`	數據提供方報告的地區，有數據時返回。
`data.timezone`	`string`	報告的時區，有數據時返回。
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.source`	`string`	媒體或查詢數據提供方的名稱。
`meta.updated_at`	`string`	查詢觀測時間，格式為 ISO 8601。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/tools/ip?ip=8.8.8.8' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/tools/ip?ip=8.8.8.8",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/tools/ip?ip=8.8.8.8",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": {
    "asn": "AS15169",
    "country_code": "US",
    "ip": "8.8.8.8",
    "organization": "Google LLC"
  },
  "error": null,
  "meta": {
    "source": "IPinfo",
    "updated_at": "2026-11-14T00:00:00Z"
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

工具箱

DNS 查詢

通過現有 daemon 查詢服務解析公開 DNS 記錄。

GET/api/v1/tools/dns

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數類型說明

參數	類型	說明
`input`必填	`string`	域名；PTR 也接受公網 IP 地址。
`type`可選	`string`	記錄類型，默認 A。允許值: `A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, SRV, PTR`
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

input必填

string

域名；PTR 也接受公網 IP 地址。

type可選

string

記錄類型，默認 A。

允許值: A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, SRV, PTR

locale可選

string

響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · DNSResult

欄位	類型	說明
`data`	`object`	標準化查詢結果；列表始終為陣列。
`data.dnssec`	`boolean`	DNS 解析服務是否驗證了該響應。
`data.name`	`string`	規範化後的 DNS 查詢名稱。
`data.records`	`object[]`	返回的 DNS 記錄，數組可以為空。
`data.records[].data`	`string`	DNS 記錄內容。
`data.records[].name`	`string`	DNS 記錄的所屬名稱。
`data.records[].ttl`	`integer`	記錄的生存時間，單位為秒。
`data.records[].type`	`string`	DNS 記錄類型。
`data.status`	`string`	DNS 響應狀態：NOERROR 或 NXDOMAIN。
`data.type`	`string`	請求的 DNS 記錄類型。
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.source`	`string`	媒體或查詢數據提供方的名稱。
`meta.updated_at`	`string`	查詢觀測時間，格式為 ISO 8601。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/tools/dns?input=example.com&type=A' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/tools/dns?input=example.com\u0026type=A",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/tools/dns?input=example.com\u0026type=A",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": {
    "dnssec": true,
    "name": "example.com",
    "records": [
      {
        "data": "93.184.215.14",
        "name": "example.com.",
        "ttl": 300,
        "type": "A"
      }
    ],
    "status": "NOERROR",
    "type": "A"
  },
  "error": null,
  "meta": {
    "source": "Google Public DNS",
    "updated_at": "2026-11-14T00:00:00Z"
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

工具箱

WHOIS 查詢

通過 RDAP 查詢域名的公開註冊資料。

GET/api/v1/tools/whois

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數	類型	說明
`input`必填	`string`	公網域名。
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · WhoisResult

欄位	類型	說明
`data`	`object`	標準化查詢結果；列表始終為陣列。
`data.dnssec`	`boolean`	域名是否啟用 DNSSEC 簽名，僅在返回該信息時存在。
`data.domain`	`string`	規範化域名。
`data.events`	`object[]`	域名註冊生命週期事件。
`data.events[].action`	`string`	—
`data.events[].date`	`string`	—
`data.handle`	`string`	註冊局標識。
`data.nameservers`	`string[]`	已註冊的域名服務器列表。
`data.registrar`	`string`	註冊商名稱，僅在返回該信息時存在。
`data.status`	`string[]`	域名註冊狀態列表。
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.source`	`string`	媒體或查詢數據提供方的名稱。
`meta.updated_at`	`string`	查詢觀測時間，格式為 ISO 8601。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/tools/whois?input=example.com' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/tools/whois?input=example.com",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/tools/whois?input=example.com",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": {
    "domain": "example.com",
    "events": [
      {
        "action": "registration",
        "date": "2000-01-01T00:00:00Z"
      }
    ],
    "handle": "EXAMPLE",
    "nameservers": [
      "ns.example.com"
    ],
    "status": [
      "active"
    ]
  },
  "error": null,
  "meta": {
    "source": "RDAP",
    "updated_at": "2026-11-14T00:00:00Z"
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。

工具箱

匯率查詢

查詢貨幣對的參考匯率，響應時間標明數據的參考日期。

GET/api/v1/tools/forex

授權

在以下任意一種請求頭中傳遞有效的 API 密鑰。

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>

請求限速

每秒一次，同一賬戶的全部密鑰共用額度。調用限速 ↗

查詢參數

參數	類型	說明
`from`必填	`string`	源貨幣，例如 USD。
`to`必填	`string`	目標貨幣，例如 CNY。
`locale`可選	`string`	響應標籤及文章鏈接的語言：en、zh-cn、zh-tw、es、de、ja 或 fr，默認 en；不篩選文章原文語言。

響應字段 200

application/json · ForexResult

欄位	類型	說明
`data`	`object`	標準化查詢結果；列表始終為陣列。
`data.base`	`string`	源貨幣代碼。
`data.date`	`string`	參考匯率日期；源貨幣與目標貨幣相同時為空。
`data.quote`	`string`	目標貨幣代碼。
`data.rate`	`number`	一單位源貨幣對應的目標貨幣數量。
`error`	`null`	失敗時為錯誤物件，成功時為 null。
`meta`	`object`	分頁、資料來源和觀測時間等中繼資料。
`meta.source`	`string`	媒體或查詢數據提供方的名稱。
`meta.updated_at`	`string`	查詢觀測時間，格式為 ISO 8601。

請求示例

cURL

curl --request GET \
  --url 'https://alphax.pro/api/v1/tools/forex?from=USD&to=CNY' \
  --header "Authorization: Bearer $API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://alphax.pro/api/v1/tools/forex?from=USD\u0026to=CNY",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
with urllib.request.urlopen(request, timeout=15) as response:
    print(json.load(response))

JavaScript (Node.js)

const response = await fetch(
  "https://alphax.pro/api/v1/tools/forex?from=USD\u0026to=CNY",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

響應示例

HTTP 200

{
  "data": {
    "base": "USD",
    "date": "2026-11-13",
    "quote": "CNY",
    "rate": 7.2
  },
  "error": null,
  "meta": {
    "source": "Frankfurter",
    "updated_at": "2026-11-14T00:00:00Z"
  }
}

HTTP 401

{
  "data": null,
  "error": {
    "code": "invalid_api_key",
    "message": "Create an API key in your registered account and send it in Authorization: Bearer or X-API-Key."
  },
  "meta": {}
}

HTTP 429

{
  "data": null,
  "error": {
    "code": "rate_limited",
    "message": "All API keys on this account share one request per second."
  },
  "meta": {}
}

響應示例為演示數據，並非實時行情。