🚀 快速开始-HXKlineDataFeed

HXKline 支持多种下载方式，你可以通过npm等包管理工具，也可以通过CDN获取。

TIP

• 开始使用前，请保证环境满足要求，环境要求参阅：👉环境要求
• 由于组件涉及到数据请求，所以组件设置了组件锁以保证服务不会被滥用，开发时可使用测试授权，发布前请申请项目授权码！申请方式参阅：👉组件锁

1、获取 HXKline

HXKline 支持多种下载方式，你可以通过npm等包管理工具，也可以通过CDN获取。

使用 npm

npm set registry https://miniapp.10jqka.com.cn/npmserver/
# or
npm set registry http://112.90.157.23/

npm install @ths-m/HXKline

使用 CDN

注意版本号 ⚠️

# 国内
https://s.thsi.cn/cd/b2cweb-component-hxkline-front/index.[顶部HXKline版本号].js
# 海外
https://cdn.ainvest.com/frontResources/s/b2cweb-component-hxkline-front/index_ainvest.[顶部HXKline版本号].js

TIP

• 完整cdn地址需要拼接版本号，版本号参考Header顶部标题栏
• 例如：https://s.thsi.cn/cd/b2cweb-component-hxklinechart-front/index.2.0.17.js
• 海外版注意_ainvest后缀

2、引入

• npm或yarn

// 国内
import * as HXKline from '@ths-m/HXKline';
// or 海外
import * as HXKline from '@ths-m/HXKline/dist/index_ainvest.js';

WARNING

• 由于使用同一份package配置，海外版使用ts类型时，ts类型仍旧需要从@ths-m/HXKlineChart或@ths-m/HXKline中引入
• 例如：import { SourceModeMap } from '@ths-m/HXKline';

3、授权

• 

WARNING

• 请勿在生产环境使用测试密钥

const projectInfo = {
  id: 'hxkline-test',
  token:
    'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdXRob3JpemVyX25hbWVzcGFjZSI6ImNvbW1vbi1ocS1hZ2dyIiwibGljZW5zZWVfdHlwZSI6IkZST05UX0FQUCIsImxpY2Vuc2VlX25hbWVzcGFjZSI6Imh4a2xpbmUtdGVzdCJ9.W2sg74tpiTpTNv0X-94WkrXJqOJK8BgV4479GmDNOvY',
};
HXKline.verifyProjectPermission(projectInfo);

• 

  // ⚠ 以下测试密钥仅用于开发环境，请勿在生产环境使用！
  const projectInfo = {
  id:'test_id',
  name:'test_name',
  version:'test_version',
  projectKey = 'DW0/LBRJRhkVPSM1OzZrXWENVh8BWkkSRQkEPCUIE14TbXpqQBYWHhkhOUhocD0UMBdoBAEKAFleAlU1';
  };
  HXKline.verifyProjectPermission(projectInfo);

4、设置业务域

• 设置业务域：由于目前HXKline支持多种业务域（例如测试环境、海外和特殊业务场景），所以在授权后需要设置业务域，否则会请求到错误的数据或者报错

// 国内-正式（默认✅）
HXKline.setProjectMode('China');
// 国内-测试
HXKline.setProjectMode('ChinaTest');
// 国内-缓存
HXKline.setProjectMode('ChinaCache');
// 海外-正式
HXKline.setProjectMode('Ainvest');
// 海外-测试
HXKline.setProjectMode('AinvestTest');
// 海外-回放
HXKline.setProjectMode('AinvestReplay');

5、获取数据

• 5.1、调用 创建数据池实例 API 创建实例，获取行情数据依赖实例的 api

const dataFeed = HXKline.initDataFeed();

• 5.2、调用 数据池实例 API 获取行情数据（依赖 5.1 创建的dataFeed实例）

获取分时数据

const trendDemo = {
  code_list: [
    {
      codes: ['300033'],
      market: '33',
    },
  ],
  trade_class: 'intraday',
  trade_date: 0,
};
const dataTrend = await dataFeed.getTrendData(trendDemo);
const dataTrendWithTime = await dataFeed.getTrendDataWithTime(trendDemo);
console.log('trendDemo', dataTrend, dataTrendWithTime);

获取K线数据

const klineDemo = {
  code_list: [
    {
      codes: ['300033'],
      market: '33',
    },
  ],
  time_period: 'day_1',
  trade_class: 'intraday',
  begin_time: -10,
  end_time: 0,
};
const dataKline = await dataFeed.getKlineData(klineDemo);
      console.log('klineDemo', dataKline);

获取快照数据

const snapshotDemo = {
  code_list: [
    {
      codes: ['300033'],
      market: '33',
    },
  ],
  trade_class: 'intraday',
  data_fields: ['7', '8', '9', '55'],
};
const dataSnapshot = await dataFeed.getSnapshotData(snapshotDemo);
console.log('snapshotDemo', dataSnapshot);

获取更多数据请参阅：👉数据池实例 API