外汇数据

股票API 外汇API 指数API。支持主流市场股票（美国、香港、中国、新加坡、日本等）、全球外汇、指数以及加密货币的实时、历史数据。标准易用接口风格，简明的文档以及丰富的各类示例，帮助开发者快速接入。提供长期免费股票API、免费外汇API、免费指数API、免费加密货币API的实时报价数据以及历史K线等金融数据。

Forex

GET K线查询

GET /forex/kline

Params

Name	Location	Type	Required	Description
region	query	string	yes	市场代码
code	query	string	yes	产品代码
kType	query	string	yes	周期 1分钟、2五分钟、3十分钟、4三十分钟、5一小时、6两小时、7四小时、8一天、9一周、10一月

Response Examples

{
  "code": 0,
  "msg": null,
  "data": [
    {
      "tu": 7,
      "c": 1.568,
      "t": 1729090560000,
      "v": 4,
      "h": 1.568,
      "l": 1.568,
      "o": 1.568
    }
  ]
}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline

Responses Data Schema

HTTP Status Code 200

Name	Type	Required	Restrictions	Title	description
» code	integer	true	none	响应码	0:成功
» msg	null	true	none	异常信息	不为0时存在
» data	[object]	true	none	响应数据	none
»» tu	integer	true	none		none
»» c	number	true	none		none
»» t	integer	true	none		none
»» v	integer	true	none		none
»» h	number	true	none		none
»» l	number	true	none		none
»» o	number	true	none		none

GET 实时报价

GET /forex/quote

Params

Name	Location	Type	Required	Description
region	query	string	yes	市场代码
code	query	string	yes	产品代码

Response Examples

{
  "code": 0,
  "msg": null,
  "data": {
    "s": "BA_BTC_USDT",
    "ld": 67600,
    "t": 1729087440311,
    "v": 0.02989,
    "tu": 2020.564,
    "ts": 0
  }
}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline

Responses Data Schema

HTTP Status Code 200

Name	Type	Required	Restrictions	Title	description
» code	integer	true	none		响应码,0:成功
» msg	null	true	none		异常信息,不为0时存在
» data	Tick	true	none		响应数据
»» s	string	true	none		symbol标的代码
»» ld	integer	true	none		最新价
»» t	integer	true	none		最新成交的时间戳
»» v	number	true	none		成交量
»» tu	number	true	none		成交额
»» ts	integer	true	none		标的交易状态

GET 实时成交

GET /forex/tick

Params

Name	Location	Type	Required	Description
region	query	string	yes	市场代码
code	query	string	yes	产品代码

Response Examples

{
  "code": 0,
  "msg": null,
  "data": {
    "s": "BA_BTC_USDT",
    "ld": 67600,
    "t": 1729087440311,
    "v": 0.02989,
    "tu": 2020.564,
    "ts": 0
  }
}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline

Responses Data Schema

HTTP Status Code 200

Name	Type	Required	Restrictions	Title	description
» code	integer	true	none		响应码,0:成功
» msg	null	true	none		异常信息,不为0时存在
» data	Tick	true	none		响应数据
»» s	string	true	none		symbol标的代码
»» ld	integer	true	none		最新价
»» t	integer	true	none		最新成交的时间戳
»» v	number	true	none		成交量
»» tu	number	true	none		成交额
»» ts	integer	true	none		标的交易状态

GET 批量K线查询

GET /forex/klines

Params

Name	Location	Type	Required	Description
region	query	string	yes	市场代码
codes	query	string	yes	产品代码
kType	query	string	yes	周期 1分钟、2五分钟、3十分钟、4三十分钟、5一小时、6两小时、7四小时、8一天、9一周、10一月

Response Examples

{
  "code": 0,
  "msg": null,
  "data": [
    {
      "tu": 7,
      "c": 1.568,
      "t": 1729090560000,
      "v": 4,
      "h": 1.568,
      "l": 1.568,
      "o": 1.568
    }
  ]
}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline

Responses Data Schema

HTTP Status Code 200

返回结果

Name	Type	Required	Restrictions	Title	description
» code	integer	true	none		响应码 0:成功
» msg	string	false	none		异常信息 不为0时存在
» data	object	true	none		响应数据
»» code	[Kline]	true	none		none
»»» tu	number	false	none		成交金额
»»» c	number	false	none		该K线收盘价
»»» t	integer	false	none		时间戳
»»» v	integer	false	none		成交数量
»»» h	number	false	none		该K线最高价
»»» l	number	false	none		该K线最低价
»»» o	number	false	none		该K线开盘价

GET 实时盘口

GET /forex/depth

Params

Name	Location	Type	Required	Description
region	query	string	yes	市场代码
code	query	string	yes	产品代码

Response Examples

{
  "code": 0,
  "msg": null,
  "data": {
    "s": "BA_BTC_USDT",
    "a": [
      {
        "po": 1,
        "p": 67800,
        "v": 0.36339,
        "o": 0.36339
      },
      {
        "po": 2,
        "p": 67800.04,
        "v": 0.00037,
        "o": 0.00037
      },
      {
        "po": 3,
        "p": 67800.28,
        "v": 0.00018,
        "o": 0.00018
      },
      {
        "po": 4,
        "p": 67800.51,
        "v": 0.00019,
        "o": 0.00019
      },
      {
        "po": 5,
        "p": 67800.52,
        "v": 0.0001,
        "o": 0.0001
      }
    ],
    "b": [
      {
        "po": 1,
        "p": 67799.99,
        "v": 2.49817,
        "o": 2.49817
      },
      {
        "po": 2,
        "p": 67799.98,
        "v": 0.06575,
        "o": 0.06575
      },
      {
        "po": 3,
        "p": 67799.96,
        "v": 0.09079,
        "o": 0.09079
      },
      {
        "po": 4,
        "p": 67799.95,
        "v": 0.1001,
        "o": 0.1001
      },
      {
        "po": 5,
        "p": 67799.05,
        "v": 0.0001,
        "o": 0.0001
      }
    ]
  }
}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline

Responses Data Schema

HTTP Status Code 200

Name	Type	Required	Restrictions	Title	description
» code	integer	true	none	响应码	0:成功
» msg	null	true	none	异常信息	不为0时存在
» data	object	true	none	响应数据	none
»» s	string	true	none	标的代码	none
»» a	[object]	true	none	卖盘	none
»»» po	integer	true	none	档位	none
»»» p	integer	true	none	价格	none
»»» v	number	true	none	挂单量	none
»»» o	number	true	none	订单数量	none
»» b	[object]	true	none	买盘	none
»»» po	integer	true	none	档位	none
»»» p	number	true	none	价格	none
»»» v	number	true	none	挂单量	none
»»» o	number	true	none	订单数量	none

GET 批量实时成交

GET /forex/ticks

Params

Name	Location	Type	Required	Description
region	query	string	yes	市场代码
codes	query	string	yes	产品代码

Response Examples

{
  "code": 0,
  "msg": null,
  "data": {
    "s": "BTCUSDT",
    "ld": 67600,
    "t": 1729087440311,
    "v": 0.02989,
    "tu": 2020.564,
    "ts": 0
  }
}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline

Responses Data Schema

HTTP Status Code 200

返回结果

Name	Type	Required	Restrictions	Title	description
» code	integer	true	none		响应码，0:成功
» msg	null	true	none		异常信息，不为0时存在
» data	object	true	none		响应数据
»» s	string	true	none		symbol标的代码
»» ld	integer	true	none		最新价
»» t	integer	true	none		最新成交的时间戳
»» v	number	true	none		成交量
»» tu	number	true	none		成交额
»» ts	integer	true	none		标的交易状态

GET 批量实时报价

GET /forex/quotes

Params

Name	Location	Type	Required	Description
region	query	string	yes	市场代码
codes	query	string	yes	产品代码

Response Examples

{
  "code": 0,
  "msg": null,
  "data": {
    "s": "BTCUSDT",
    "ld": 67600,
    "t": 1729087440311,
    "v": 0.02989,
    "tu": 2020.564,
    "ts": 0
  }
}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline

Responses Data Schema

HTTP Status Code 200

返回结果

Name	Type	Required	Restrictions	Title	description
» code	integer	true	none		响应码，0:成功
» msg	null	true	none		异常信息，不为0时存在
» data	object	true	none		响应数据
»» s	string	true	none		symbol标的代码
»» ld	integer	true	none		最新价
»» t	integer	true	none		最新成交的时间戳
»» v	number	true	none		成交量
»» tu	number	true	none		成交额
»» ts	integer	true	none		标的交易状态

GET 标的查询

GET /forex/base

Params

Name	Location	Type	Required	Description
region	query	string	yes	市场代码
code	query	string	yes	产品代码

Response Examples

{
  "code": 0,
  "msg": null,
  "data": {
    "s": "839.HK",
    "nc": "中教控股",
    "ne": "CHINA EDU GROUP",
    "nh": "中教控股",
    "e": "SEHK",
    "c": "HKD",
    "l": 1000,
    "t": 2713791221,
    "cs": 2713791221,
    "hs": 2713791221,
    "ep": 0.5555219630532146,
    "ept": 0.5984943570767414,
    "bps": 6.618762900073513,
    "dy": 0.3387696962454725,
    "b": "HKEquity"
  }
}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline

Responses Data Schema

HTTP Status Code 200

Name	Type	Required	Restrictions	Title	description
» code	integer	true	none	响应码	0:成功
» msg	null	true	none	异常信息	不为0时存在
» data	object	true	none	响应数据	none
»» s	string	true	none	产品代码	none
»» nc	string	true	none	中文简体标的名称	none
»» ne	string	true	none	英文标的名称	none
»» nh	string	true	none	中文繁体标的名称	none
»» e	string	true	none	标的所属交易所	none
»» c	string	true	none	交易币种	CNY:USD；SGD:HKD
»» l	integer	true	none	每手股数	none
»» t	integer	true	none	总股本	none
»» cs	integer	true	none	流通股本	none
»» hs	integer	true	none	港股股本 (仅港股)	none
»» ep	number	true	none	每股盈利	none
»» ept	number	true	none	每股盈利 (TTM)	none
»» bps	number	true	none	每股净资产	none
»» dy	number	true	none	股息	none
»» b	string	true	none	标的所属板块	none
»» sd	string	true	none	如果标的是正股，可提供的衍生品行情类型	1 - 期权；2 - 轮证

GET 批量实时盘口

GET /forex/depths

Params

Name	Location	Type	Required	Description
region	query	string	yes	市场代码
codes	query	string	yes	产品代码

Response Examples

{
  "code": 0,
  "msg": null,
  "data": {
    "s": "BA_BTC_USDT",
    "a": [
      {
        "po": 1,
        "p": 67800,
        "v": 0.36339,
        "o": 0.36339
      },
      {
        "po": 2,
        "p": 67800.04,
        "v": 0.00037,
        "o": 0.00037
      },
      {
        "po": 3,
        "p": 67800.28,
        "v": 0.00018,
        "o": 0.00018
      },
      {
        "po": 4,
        "p": 67800.51,
        "v": 0.00019,
        "o": 0.00019
      },
      {
        "po": 5,
        "p": 67800.52,
        "v": 0.0001,
        "o": 0.0001
      }
    ],
    "b": [
      {
        "po": 1,
        "p": 67799.99,
        "v": 2.49817,
        "o": 2.49817
      },
      {
        "po": 2,
        "p": 67799.98,
        "v": 0.06575,
        "o": 0.06575
      },
      {
        "po": 3,
        "p": 67799.96,
        "v": 0.09079,
        "o": 0.09079
      },
      {
        "po": 4,
        "p": 67799.95,
        "v": 0.1001,
        "o": 0.1001
      },
      {
        "po": 5,
        "p": 67799.05,
        "v": 0.0001,
        "o": 0.0001
      }
    ]
  }
}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline

Responses Data Schema

HTTP Status Code 200

Name	Type	Required	Restrictions	Title	description
» code	integer	true	none		响应码,0:成功
» msg	null	true	none		异常信息,不为0时存在
» data	Depth	true	none		响应数据
»» s	string	true	none		标的代码
»» a	[object]	true	none		卖盘
»»» po	integer	true	none		档位
»»» p	number	true	none		价格
»»» v	number	true	none		挂单量
»»» o	number	true	none		订单数量
»» b	[object]	true	none		买盘
»»» po	integer	true	none		档位
»»» p	number	true	none		价格
»»» v	number	true	none		挂单量
»»» o	number	true	none		订单数量

Data Schema

Kline

{
  "tu": 0,
  "c": 0,
  "t": 0,
  "v": 0,
  "h": 0,
  "l": 0,
  "o": 0
}

Attribute

Name	Type	Required	Restrictions	Title	Description
tu	number	false	none		成交金额
c	number	false	none		该K线收盘价
t	integer	false	none		时间戳
v	integer	false	none		成交数量
h	number	false	none		该K线最高价
l	number	false	none		该K线最低价
o	number	false	none		该K线开盘价

Tick

{
  "s": "string",
  "ld": 0,
  "t": 0,
  "v": 0,
  "tu": 0,
  "ts": 0
}

Tick

Attribute

Name	Type	Required	Restrictions	Title	Description
s	string	true	none		symbol标的代码
ld	integer	true	none		最新价
t	integer	true	none		最新成交的时间戳
v	number	true	none		成交量
tu	number	true	none		成交额
ts	integer	true	none		标的交易状态

Depth

{
  "s": "string",
  "a": [
    {
      "po": 0,
      "p": 0,
      "v": 0,
      "o": 0
    }
  ],
  "b": [
    {
      "po": 0,
      "p": 0,
      "v": 0,
      "o": 0
    }
  ]
}

Attribute

Name	Type	Required	Restrictions	Title	Description
s	string	true	none		标的代码
a	[object]	true	none		卖盘
» po	integer	true	none		档位
» p	number	true	none		价格
» v	number	true	none		挂单量
» o	number	true	none		订单数量
b	[object]	true	none		买盘
» po	integer	true	none		档位
» p	number	true	none		价格
» v	number	true	none		挂单量
» o	number	true	none		订单数量