股票实时行情数据源-Github开源项目

1. 开源项目

XTick行情API提供了全面、准确、稳定的行情数据，帮助开发者和研究者构建创新的交易和分析工具，满足金融行业的需求，进行深入的市场分析和模型验证。

1. GitHub地址

https://github.com/xticktop/xtick

XTick官网：http://www.xtick.top/

如遇问题联系作者，邮箱：xticktop@163.com

1. API接口文档

API接口分为订阅数据、行情数据、财务数据三个部分。行情数据支持盘中实时更新。

除了订阅接口是Websocket API，其余接口为Http API接口且均支持GET和POST方法，下面以GET请求示例。

1. 订阅数据接口

在GitHub上，已实现Java版本和Python版本的订阅代码，请先下载代码直接调用。

暂时无法在飞书文档外展示此内容

订阅数据按照证券交易所订阅推送，包括上交所、深交所、北交所、港交所（只支持部分股票）。

数据为实时推送，发数据非常快，客户端接受到数据后，最好做异步处理，将接受数据和数据处理分开，避免接受数据阻塞。

1. 订阅方法：

订阅数据：订阅为Websocket API，请在Github上下载开源项目，参考XTickWebSocketClient.java中已实现的订阅功能。

入参1：authCodes 枚举取值如下：

• tick.SZ - 订阅深交所A股的tick数据。

• tick.SH - 订阅上交所A股的tick数据。

• tick.BJ - 订阅北交所A股的tick数据。

• tick.HK - 订阅港交所港股的tick数据。

• time.SZ - 订阅深交所A股的k线数据，包括time、1m。

• time.SH - 订阅上交所A股的k线数据，包括time、1m。

• time.BJ - 订阅北交所A股的k线数据，包括time、1m。

• time.HK - 订阅港交所港股的k线数据，包括time、1m。

入参2：token 登录XTick网站，注册获取

取消订阅：http://api.xtick.top/doc/unsubscribe?token=043fbdcba7f3f3ab332ffff123456789

入参：token 登录XTick网站，注册获取

1. 行情数据接口

1. 请求方法：

请求地址：http://api.xtick.top/doc/market?type=1&code=000001&period=tick&fq=none&startDate=2025-03-25&endDate=2025-03-25&token=043fbdcba7f3f3ab332ffff123456789

备注：行情数据支持交易日内盘内实时更新。

入参1：type 股票类别

沪深京A股type=1，港股type=3;

入参2：code 股票代码

比如平安银行为000001

入参3：period 用于表示要获取的周期，枚举取值如下：

• tick - 分笔数据

• 1m - 1分钟线

• 5m - 5分钟线

• 15m - 15分钟线

• 30m - 30分钟线

• 1h - 1小时线

• 1d - 日线

• 1w - 周线

• 1mon - 月线

• 1q - 季度线

• 1hy - 半年线

• 1y - 年线

参数4：fq 除权方式，用于K线数据复权计算，对tick等其他周期数据无效，枚举取值如下：

• none 不复权

• front 前复权

• back 后复权

• front_ratio 等比前复权

• back_ratio 等比后复权

参数5：时间范围，用于指定数据请求范围，表示的范围是[startDate , endDate]区间（包含前后边界）。

特别说明：period为tick类型，则单次请求时间跨度最大为一天，即startDate和endDate日期需设置为同一天。

period为分钟类型（包括1m、5m、15m、30m、1h），则单次请求时间跨度最大为一月，即endDate - startDate不超过30天。

• startDate - 起始时间，日期格式：2025-03-25

• endDate- 结束时间，日期格式：2025-03-25

入参6：token 登录XTick网站，注册获取

1. 财务数据接口

1. 请求方法：

请求地址：http://api.xtick.top/doc/financial?type=1&code=000001&report=Pershareindex&startDate=2020-03-25&endDate=2025-03-25&token=043fbdcba7f3f3ab332ffff123456789

入参1：type 股票类别

沪深京A股type=1，港股type=3;

入参2：code 股票代码

比如平安银行为000001

入参3：report 用于表示要获取的财务报表，枚举取值如下：

• Balance - 资产负债表

• Income - 利润表

• CashFlow - 现金流量表

• Capital - 股本表

• Holdernum - 股东数

• Top10holder - 十大股东

• Top10flowholder - 十大流通股东

• Pershareindex - 每股指标

参数4：时间范围，用于指定数据请求范围，表示的范围是[startDate , endDate]区间（包含前后边界）。

• startDate - 起始时间，日期格式：2025-03-25

• endDate- 结束时间，日期格式：2025-03-25

入参5：token 登录XTick网站，注册获取

1. 数据字段定义

字段定义说明：

1. tick数据

'time' #时间戳 'lastPrice' #最新价 'open' #开盘价 'high' #最高价 'low' #最低价 'lastClose' #前收盘价 'amount' #成交总额 'volume' #成交总量(手) 'askPrice' #委卖价，五档委卖价格 'bidPrice' #委买价，五档委买价格 'askVol' #委卖量，五档委卖量 'bidVol' #委买量，五档委买量

1. k线数据

'time' #时间戳 'open' #开盘价 'high' #最高价 'low' #最低价 'close' #收盘价 'amount' #成交总额 'volume' #成交总量（手）

1. Balance-资产负债表

'm_anntime' #披露日期 'm_timetag' #截止日期 'internal_shoule_recv' #内部应收款 'fixed_capital_clearance' #固定资产清理 'should_pay_money' #应付分保账款 'settlement_payment' #结算备付金 'receivable_premium' #应收保费 'accounts_receivable_reinsurance' #应收分保账款 'reinsurance_contract_reserve' #应收分保合同准备金 'dividends_payable' #应收股利 'tax_rebate_for_export' #应收出口退税 'subsidies_receivable' #应收补贴款 'deposit_receivable' #应收保证金 'apportioned_cost' #待摊费用 'profit_and_current_assets_with_deal' #待处理流动资产损益 'current_assets_one_year' #一年内到期的非流动资产 'long_term_receivables' #长期应收款 'other_long_term_investments' #其他长期投资 'original_value_of_fixed_assets' #固定资产原值 'net_value_of_fixed_assets' #固定资产净值 'depreciation_reserves_of_fixed_assets' #固定资产减值准备 'productive_biological_assets' #生产性生物资产 'public_welfare_biological_assets' #公益性生物资产 'oil_and_gas_assets' #油气资产 'development_expenditure' #开发支出 'right_of_split_share_distribution' #股权分置流通权 'other_non_mobile_assets' #其他非流动资产 'handling_fee_and_commission' #应付手续费及佣金 'other_payables' #其他应交款 'margin_payable' #应付保证金 'internal_accounts_payable' #内部应付款 'advance_cost' #预提费用 'insurance_contract_reserve' #保险合同准备金 'broker_buying_and_selling_securities' #代理买卖证券款 'acting_underwriting_securities' #代理承销证券款 'international_ticket_settlement' #国际票证结算 'domestic_ticket_settlement' #国内票证结算 'deferred_income' #递延收益 'short_term_bonds_payable' #应付短期债券 'long_term_deferred_income' #长期递延收益 'undetermined_investment_losses' #未确定的投资损失 'quasi_distribution_of_cash_dividends' #拟分配现金股利 'provisions_not' #预计负债 'cust_bank_dep' #吸收存款及同业存放 'provisions' #预计流动负债 'less_tsy_stk' #减:库存股 'cash_equivalents' #货币资金 'loans_to_oth_banks' #拆出资金 'tradable_fin_assets' #交易性金融资产 'derivative_fin_assets' #衍生金融资产 'bill_receivable' #应收票据 'account_receivable' #应收账款 'advance_payment' #预付款项 'int_rcv' #应收利息 'other_receivable' #其他应收款 'red_monetary_cap_for_sale' #买入返售金融资产 'agency_bus_assets' #以公允价值计量且其变动计入当期损益的金融资产 'inventories' #存货 'other_current_assets' #其他流动资产 'total_current_assets' #流动资产合计 'loans_and_adv_granted' #发放贷款及垫款 'fin_assets_avail_for_sale' #可供出售金融资产 'held_to_mty_invest' #持有至到期投资 'long_term_eqy_invest' #长期股权投资 'invest_real_estate' #投资性房地产 'accumulated_depreciation' #累计折旧 'fix_assets' #固定资产 'constru_in_process' #在建工程 'construction_materials' #工程物资 'long_term_liabilities' #长期负债 'intang_assets' #无形资产 'goodwill' #商誉 'long_deferred_expense' #长期待摊费用 'deferred_tax_assets' #递延所得税资产 'total_non_current_assets' #非流动资产合计 'tot_assets' #资产总计 'shortterm_loan' #短期借款 'borrow_central_bank' #向中央银行借款 'loans_oth_banks' #拆入资金 'tradable_fin_liab' #交易性金融负债 'derivative_fin_liab' #衍生金融负债 'notes_payable' #应付票据 'accounts_payable' #应付账款 'advance_peceipts' #预收账款 'fund_sales_fin_assets_rp' #卖出回购金融资产款 'empl_ben_payable' #应付职工薪酬 'taxes_surcharges_payable' #应交税费 'int_payable' #应付利息 'dividend_payable' #应付股利 'other_payable' #其他应付款 'non_current_liability_in_one_year' #一年内到期的非流动负债 'other_current_liability' #其他流动负债 'total_current_liability' #流动负债合计 'long_term_loans' #长期借款 'bonds_payable' #应付债券 'longterm_account_payable' #长期应付款 'grants_received' #专项应付款 'deferred_tax_liab' #递延所得税负债 'other_non_current_liabilities' #其他非流动负债 'non_current_liabilities' #非流动负债合计 'tot_liab' #负债合计 'cap_stk' #实收资本(或股本) 'cap_rsrv' #资本公积 'specific_reserves' #专项储备 'surplus_rsrv' #盈余公积 'prov_nom_risks' #一般风险准备 'undistributed_profit' #未分配利润 'cnvd_diff_foreign_curr_stat' #外币报表折算差额 'tot_shrhldr_eqy_excl_min_int' #归属于母公司股东权益合计 'minority_int' #少数股东权益 'total_equity' #所有者权益合计 'tot_liab_shrhldr_eqy' #负债和股东权益总计

1. Income-利润表

'm_anntime' #披露日期 'm_timetag' #截止日期 'revenue_inc' #营业收入 'earned_premium' #已赚保费 'real_estate_sales_income' #房地产销售收入 'total_operating_cost' #营业总成本 'real_estate_sales_cost' #房地产销售成本 'research_expenses' #研发费用 'surrender_value' #退保金 'net_payments' #赔付支出净额 'net_withdrawal_ins_con_res' #提取保险合同准备金净额 'policy_dividend_expenses' #保单红利支出 'reinsurance_cost' #分保费用 'change_income_fair_value' #公允价值变动收益 'futures_loss' #期货损益 'trust_income' #托管收益 'subsidize_revenue' #补贴收入 'other_business_profits' #其他业务利润 'net_profit_excl_merged_int_inc' #被合并方在合并前实现净利润 'int_inc' #利息收入 'handling_chrg_comm_inc' #手续费及佣金收入 'less_handling_chrg_comm_exp' #手续费及佣金支出 'other_bus_cost' #其他业务成本 'plus_net_gain_fx_trans' #汇兑收益 'il_net_loss_disp_noncur_asset' #非流动资产处置收益 'inc_tax' #所得税费用 'unconfirmed_invest_loss' #未确认投资损失 'net_profit_excl_min_int_inc' #归属于母公司所有者的净利润 'less_int_exp' #利息支出 'other_bus_inc' #其他业务收入 'revenue' #营业总收入 'total_expense' #营业成本 'less_taxes_surcharges_ops' #营业税金及附加 'sale_expense' #销售费用 'less_gerl_admin_exp' #管理费用 'financial_expense' #财务费用 'less_impair_loss_assets' #资产减值损失 'plus_net_invest_inc' #投资收益 'incl_inc_invest_assoc_jv_entp' #联营企业和合营企业的投资收益 'oper_profit' #营业利润 'plus_non_oper_rev' #营业外收入 'less_non_oper_exp' #营业外支出 'tot_profit' #利润总额 'net_profit_incl_min_int_inc' #净利润 'net_profit_incl_min_int_inc_after' #净利润(扣除非经常性损益后) 'minority_int_inc' #少数股东损益 's_fa_eps_basic' #基本每股收益 's_fa_eps_diluted' #稀释每股收益 'total_income' #综合收益总额 'total_income_minority' #归属于少数股东的综合收益总额 'other_compreh_inc' #其他收益

1. CashFlow-现金流量表

'm_anntime' #披露日期 'm_timetag' #截止日期 'cash_received_ori_ins_contract_pre' #收到原保险合同保费取得的现金 'net_cash_received_rei_ope' #收到再保险业务现金净额 'net_increase_insured_funds' #保户储金及投资款净增加额 'Net' #处置交易性金融资产净增加额 increase_in_disposal 'cash_for_interest' #收取利息、手续费及佣金的现金 'net_increase_in_repurchase_funds' #回购业务资金净增加额 'cash_for_payment_original_insurance' #支付原保险合同赔付款项的现金 'cash_payment_policy_dividends' #支付保单红利的现金 'disposal_other_business_units' #处置子公司及其他收到的现金 'cash_received_from_pledges' #减少质押和定期存款所收到的现金 'cash_paid_for_investments' #投资所支付的现金 'net_increase_in_pledged_loans' #质押贷款净增加额 'cash_paid_by_subsidiaries' #取得子公司及其他营业单位支付的现金净额 'increase_in_cash_paid' #增加质押和定期存款所支付的现金 'cass_received_sub_abs' #其中子公司吸收现金 'cass_received_sub_investments' #其中:子公司支付给少数股东的股利、利润 'minority_shareholder_profit_loss' #少数股东损益 'unrecognized_investment_losses' #未确认的投资损失 'ncrease_deferred_income' #递延收益增加(减:减少) 'projected_liability' #预计负债 'increase_operational_payables' #经营性应付项目的增加 'reduction_outstanding_amounts_less' #已完工尚未结算款的减少(减:增加) 'reduction_outstanding_amounts_more' #已结算尚未完工款的增加(减:减少) 'goods_sale_and_service_render_cash' #销售商品、提供劳务收到的现金 'net_incr_dep_cob' #客户存款和同业存放款项净增加额 'net_incr_loans_central_bank' #向中央银行借款净增加额(万元 'net_incr_fund_borr_ofi' #向其他金融机构拆入资金净增加额 'net_incr_fund_borr_ofi' #拆入资金净增加额 'tax_levy_refund' #收到的税费与返还 'cash_paid_invest' #投资支付的现金 'other_cash_recp_ral_oper_act' #收到的其他与经营活动有关的现金 'stot_cash_inflows_oper_act' #经营活动现金流入小计 'goods_and_services_cash_paid' #购买商品、接受劳务支付的现金 'net_incr_clients_loan_adv' #客户贷款及垫款净增加额 'net_incr_dep_cbob' #存放中央银行和同业款项净增加额 'handling_chrg_paid' #支付利息、手续费及佣金的现金 'cash_pay_beh_empl' #支付给职工以及为职工支付的现金 'pay_all_typ_tax' #支付的各项税费 'other_cash_pay_ral_oper_act' #支付其他与经营活动有关的现金 'stot_cash_outflows_oper_act' #经营活动现金流出小计 'net_cash_flows_oper_act' #经营活动产生的现金流量净额 'cash_recp_disp_withdrwl_invest' #收回投资所收到的现金 'cash_recp_return_invest' #取得投资收益所收到的现金 'net_cash_recp_disp_fiolta' #处置固定资产、无形资产和其他长期投资收到的现金 'other_cash_recp_ral_inv_act' #收到的其他与投资活动有关的现金 'stot_cash_inflows_inv_act' #投资活动现金流入小计 'cash_pay_acq_const_fiolta' #购建固定资产、无形资产和其他长期投资支付的现金 'other_cash_pay_ral_oper_act' #支付其他与投资的现金 'stot_cash_outflows_inv_act' #投资活动现金流出小计 'net_cash_flows_inv_act' #投资活动产生的现金流量净额 'cash_recp_cap_contrib' #吸收投资收到的现金 'cash_recp_borrow' #取得借款收到的现金 'proc_issue_bonds' #发行债券收到的现金 'other_cash_recp_ral_fnc_act' #收到其他与筹资活动有关的现金 'stot_cash_inflows_fnc_act' #筹资活动现金流入小计 'cash_prepay_amt_borr' #偿还债务支付现金 'cash_pay_dist_dpcp_int_exp' #分配股利、利润或偿付利息支付的现金 'other_cash_pay_ral_fnc_act' #支付其他与筹资的现金 'stot_cash_outflows_fnc_act' #筹资活动现金流出小计 'net_cash_flows_fnc_act' #筹资活动产生的现金流量净额 'eff_fx_flu_cash' #汇率变动对现金的影响 'net_incr_cash_cash_equ' #现金及现金等价物净增加额 'cash_cash_equ_beg_period' #期初现金及现金等价物余额 'cash_cash_equ_end_period' #期末现金及现金等价物余额 'net_profit' #净利润 'plus_prov_depr_assets' #资产减值准备 'depr_fa_coga_dpba' #固定资产折旧、油气资产折耗、生产性物资折旧 'amort_intang_assets' #无形资产摊销 'amort_lt_deferred_exp' #长期待摊费用摊销 'decr_deferred_exp' #待摊费用的减少 'incr_acc_exp' #预提费用的增加 'loss_disp_fiolta' #处置固定资产、无形资产和其他长期资产的损失 'loss_scr_fa' #固定资产报废损失 'loss_fv_chg' #公允价值变动损失 'fin_exp' #财务费用 'invest_loss' #投资损失 'decr_deferred_inc_tax_assets' #递延所得税资产减少 'incr_deferred_inc_tax_liab' #递延所得税负债增加 'decr_inventories' #存货的减少 'decr_oper_payable' #经营性应收项目的减少 'others' #其他 'im_net_cash_flows_oper_act' #经营活动产生现金流量净额 'conv_debt_into_cap' #债务转为资本 'conv_corp_bonds_due_within_1y' #一年内到期的可转换公司债券 'fa_fnc_leases' #融资租入固定资产 'end_bal_cash' #现金的期末余额 'less_beg_bal_cash' #现金的期初余额 'plus_end_bal_cash_equ' #现金等价物的期末余额 'less_beg_bal_cash_equ' #现金等价物的期初余额 'im_net_incr_cash_cash_equ' #现金及现金等价物的净增加额 'tax_levy_refund' #收到的税费返还

1. PershareIndex-主要指标

's_fa_ocfps' #每股经营活动现金流量 's_fa_bps' #每股净资产 's_fa_eps_basic' #基本每股收益 's_fa_eps_diluted' #稀释每股收益 's_fa_undistributedps' #每股未分配利润 's_fa_surpluscapitalps' #每股资本公积金 'adjusted_earnings_per_share' #扣非每股收益 'du_return_on_equity' #净资产收益率 'sales_gross_profit' #销售毛利率 'inc_revenue_rate' #主营收入同比增长 'du_profit_rate' #净利润同比增长 'inc_net_profit_rate' #归属于母公司所有者的净利润同比增长 'adjusted_net_profit_rate' #扣非净利润同比增长 'inc_total_revenue_annual' #营业总收入滚动环比增长 'inc_net_profit_to_shareholders_annual' #归属净利润滚动环比增长 'adjusted_profit_to_profit_annual' #扣非净利润滚动环比增长 'equity_roe' #加权净资产收益率 'net_roe' #摊薄净资产收益率 'total_roe' #摊薄总资产收益率 'gross_profit' #毛利率 'net_profit' #净利率 'actual_tax_rate' #实际税率 'pre_pay_operate_income' #预收款 / 营业收入 'sales_cash_flow' #销售现金流 / 营业收入 'gear_ratio' #资产负债比率 'inventory_turnover' #存货周转率 'm_anntime' #公告日 'm_timetag' #报告截止日

1. Capital-股本表

'total_capital' #总股本 'circulating_capital' #已上市流通A股 'restrict_circulating_capital' #限售流通股份 'm_timetag' #报告截止日 'm_anntime' #公告日

1. Top10holder/Top10flowholder-十大股东/十大流通股东

'declareDate' #公告日期 'endDate' #截止日期 'name' #股东名称 'type' #股东类型 'quantity' #持股数量 'reason' #变动原因 'ratio' #持股比例 'nature' #股份性质 'rank' #持股排名

1. Holdernum-股东数

'declareDate' #公告日期 'endDate' #截止日期 'shareholder' #股东总数 'shareholderA' #A股东户数 'shareholderB' #B股东户数 'shareholderH' #H股东户数 'shareholderFloat' #已流通股东户数 'shareholderOther' #未流通股东户数

1. 返回数据示例：

tick数据：

{ "301030.SZ": { "time": 1740981096000, "lastPrice": 23.17, "open": 23.25, "high": 23.77, "low": 22.82, "lastClose": 23.02, "amount": 169982500.0, "volume": 72379, "askPrice": [23.18, 23.21, 23.22, 23.240000000000002, 23.25], "bidPrice": [23.17, 23.16, 23.150000000000002, 23.14, 23.13], "askVol": [6, 73, 21, 1, 50], "bidVol": [144, 87, 64, 33, 24] }, "301031.SZ": { "time": 1740981096000, "lastPrice": 116.7, "open": 115.0, "high": 119.15, "low": 114.58, "lastClose": 114.76, "amount": 73301800.0, "volume": 6236, "askPrice": [116.69, 116.7, 116.71000000000001, 116.72, 116.74000000000001], "bidPrice": [116.66, 116.62, 116.60000000000001, 116.54, 116.51], "askVol": [2, 11, 53, 1, 9], "bidVol": [19, 3, 2, 2, 70] } }

k线数据：

[{ "time": 1742866200000, "open": 11.38, "high": 11.38, "low": 11.38, "close": 11.38, "amount": 8105974.0, "volume": 7123.0 }, { "time": 1742886000000, "open": 11.43, "high": 11.43, "low": 11.43, "close": 11.43, "amount": 6933438.0, "volume": 6066.0 }]