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": {}
}

响应示例为演示数据，并非实时行情。