@yuants/vendor-binance 0.8.7 → 0.10.0

package/dist/api/client.js

@@ -1,8 +1,7 @@
 import { GlobalPrometheusRegistry } from '@yuants/protocol';
-import { formatTime } from '@yuants/utils';
-// @ts-ignore
-import CryptoJS from 'crypto-js';
+import { formatTime, HmacSHA256, newError } from '@yuants/utils';
 const MetricBinanceApiUsedWeight = GlobalPrometheusRegistry.gauge('binance_api_used_weight', '');
+let retryAfterUntil = null;
 export const isApiError = (value) => typeof (value === null || value === void 0 ? void 0 : value.code) === 'number' && typeof (value === null || value === void 0 ? void 0 : value.msg) === 'string';
 const appendParams = (url, params) => {
     if (!params)
@@ -35,7 +34,7 @@ const callApi = async (method, endpoint, params, credential) => {
     let headers;
     if (credential) {
         const signData = url.search.slice(1);
-        const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA256(signData, credential.secret_key));
+        const signature = Buffer.from(await HmacSHA256(new TextEncoder().encode(signData), new TextEncoder().encode(credential.secret_key))).toString('hex');
         url.searchParams.set('signature', signature);
         headers = {
             'Content-Type': 'application/json;charset=utf-8',
@@ -46,12 +45,22 @@ const callApi = async (method, endpoint, params, credential) => {
     else {
         console.info(formatTime(Date.now()), method, url.href);
     }
+    if (retryAfterUntil) {
+        if (Date.now() <= retryAfterUntil) {
+            throw newError('ACTIVE_RATE_LIMIT', { retryAfterUntil, now: Date.now(), url: url.href });
+        }
+        retryAfterUntil = null;
+    }
     const res = await fetch(url.href, {
         method,
         headers,
     });
     const usedWeight1M = res.headers.get('x-mbx-used-weight-1m');
-    console.info(formatTime(Date.now()), 'response', method, url.href, res.status, `usedWeight1M=${usedWeight1M !== null && usedWeight1M !== void 0 ? usedWeight1M : 'N/A'}`);
+    const retryAfter = res.headers.get('Retry-After');
+    if (retryAfter) {
+        retryAfterUntil = Date.now() + parseInt(retryAfter, 10) * 1000;
+    }
+    console.info(formatTime(Date.now()), 'response', method, url.href, `status=${res.status}`, retryAfter ? `retryAfter=${retryAfter}` : '', `usedWeight1M=${usedWeight1M !== null && usedWeight1M !== void 0 ? usedWeight1M : 'N/A'}`);
     if (usedWeight1M) {
         MetricBinanceApiUsedWeight.set(+usedWeight1M);
     }

package/dist/api/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,aAAa;AACb,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,MAAM,0BAA0B,GAAG,wBAAwB,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;AAgBjG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,KAAoB,EAAsB,EAAE,CACxE,OAAO,CAAC,KAAmB,aAAnB,KAAK,uBAAL,KAAK,CAAgB,IAAI,CAAA,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAmB,aAAnB,KAAK,uBAAL,KAAK,CAAgB,GAAG,CAAA,KAAK,QAAQ,CAAC;AAElG,MAAM,YAAY,GAAG,CAAC,GAAQ,EAAE,MAAsB,EAAE,EAAE;IACxD,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAClF,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC;IACnE,WAAW;SACR,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;SAClD,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACxB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACL,IAAI,cAAc,EAAE;QAClB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACpE;AACH,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,KAAK,EACnB,MAAkB,EAClB,QAAgB,EAChB,MAAsB,EACtB,UAAwB,EACZ,EAAE;IACd,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,gBAAgB,qBAAuB,MAAM,CAAE,CAAC;IACtD,IAAI,UAAU,EAAE;QACd,IAAI,gBAAgB,CAAC,UAAU,KAAK,SAAS,EAAE;YAC7C,yGAAyG;YACzG,gBAAgB,CAAC,UAAU,GAAG,IAAI,CAAC;SACpC;QACD,IAAI,gBAAgB,CAAC,SAAS,KAAK,SAAS,EAAE;YAC5C,gBAAgB,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;SACzC;KACF;IACD,YAAY,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAEpC,IAAI,OAA2C,CAAC;IAChD,IAAI,UAAU,EAAE;QACd,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QACnG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC7C,OAAO,GAAG;YACR,cAAc,EAAE,gCAAgC;YAChD,cAAc,EAAE,UAAU,CAAC,UAAU;SACtC,CAAC;QACF,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EACtB,MAAM,EACN,GAAG,CAAC,IAAI,EACR,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EACvB,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,EAC3B,QAAQ,CACT,CAAC;KACH;SAAM;QACL,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;KACxD;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;QAChC,MAAM;QACN,OAAO;KACR,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EACtB,UAAU,EACV,MAAM,EACN,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,gBAAgB,YAAY,aAAZ,YAAY,cAAZ,YAAY,GAAI,KAAK,EAAE,CACxC,CAAC;IACF,IAAI,YAAY,EAAE;QAChB,0BAA0B,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;KAC/C;IACD,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,MAAkB,EAAE,QAAgB,EAAE,MAAsB,EAAE,EAAE,CAC/F,OAAO,CAAI,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEvC,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,UAAuB,EACvB,MAAkB,EAClB,QAAgB,EAChB,MAAsB,EACtB,EAAE,CAAC,OAAO,CAAI,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAgB,EAAE;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAC1C,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,EAAE;QAC9B,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;KACtF;IACD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AACpC,CAAC,CAAC","sourcesContent":["import { GlobalPrometheusRegistry } from '@yuants/protocol';\nimport { formatTime } from '@yuants/utils';\n// @ts-ignore\nimport CryptoJS from 'crypto-js';\n\nconst MetricBinanceApiUsedWeight = GlobalPrometheusRegistry.gauge('binance_api_used_weight', '');\n\ntype HttpMethod = 'GET' | 'POST' | 'DELETE' | 'PUT';\n\ntype RequestParams = Record<string, string | number | boolean | undefined>;\n\nexport interface ICredential {\n  access_key: string;\n  secret_key: string;\n}\n\nexport interface IApiError {\n  code: number;\n  msg: string;\n}\n\nexport const isApiError = <T>(value: T | IApiError): value is IApiError =>\n  typeof (value as IApiError)?.code === 'number' && typeof (value as IApiError)?.msg === 'string';\n\nconst appendParams = (url: URL, params?: RequestParams) => {\n  if (!params) return;\n  const entries = Object.entries(params).filter(([, value]) => value !== undefined);\n  const timestampEntry = entries.find(([key]) => key === 'timestamp');\n  const restEntries = entries.filter(([key]) => key !== 'timestamp');\n  restEntries\n    .sort(([keyA], [keyB]) => keyA.localeCompare(keyB))\n    .forEach(([key, value]) => {\n      url.searchParams.set(key, String(value));\n    });\n  if (timestampEntry) {\n    url.searchParams.set(timestampEntry[0], String(timestampEntry[1]));\n  }\n};\n\nconst callApi = async <T>(\n  method: HttpMethod,\n  endpoint: string,\n  params?: RequestParams,\n  credential?: ICredential,\n): Promise<T> => {\n  const url = new URL(endpoint);\n  const normalizedParams: RequestParams = { ...params };\n  if (credential) {\n    if (normalizedParams.recvWindow === undefined) {\n      // FYI https://developers.binance.com/docs/derivatives/usds-margined-futures/general-info#timing-security\n      normalizedParams.recvWindow = 5000;\n    }\n    if (normalizedParams.timestamp === undefined) {\n      normalizedParams.timestamp = Date.now();\n    }\n  }\n  appendParams(url, normalizedParams);\n\n  let headers: Record<string, string> | undefined;\n  if (credential) {\n    const signData = url.search.slice(1);\n    const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA256(signData, credential.secret_key));\n    url.searchParams.set('signature', signature);\n    headers = {\n      'Content-Type': 'application/json;charset=utf-8',\n      'X-MBX-APIKEY': credential.access_key,\n    };\n    console.info(\n      formatTime(Date.now()),\n      method,\n      url.href,\n      JSON.stringify(headers),\n      url.searchParams.toString(),\n      signData,\n    );\n  } else {\n    console.info(formatTime(Date.now()), method, url.href);\n  }\n\n  const res = await fetch(url.href, {\n    method,\n    headers,\n  });\n  const usedWeight1M = res.headers.get('x-mbx-used-weight-1m');\n  console.info(\n    formatTime(Date.now()),\n    'response',\n    method,\n    url.href,\n    res.status,\n    `usedWeight1M=${usedWeight1M ?? 'N/A'}`,\n  );\n  if (usedWeight1M) {\n    MetricBinanceApiUsedWeight.set(+usedWeight1M);\n  }\n  return res.json() as Promise<T>;\n};\n\nexport const requestPublic = <T>(method: HttpMethod, endpoint: string, params?: RequestParams) =>\n  callApi<T>(method, endpoint, params);\n\nexport const requestPrivate = <T>(\n  credential: ICredential,\n  method: HttpMethod,\n  endpoint: string,\n  params?: RequestParams,\n) => callApi<T>(method, endpoint, params, credential);\n\nexport const getDefaultCredential = (): ICredential => {\n  const access_key = process.env.ACCESS_KEY;\n  const secret_key = process.env.SECRET_KEY;\n  if (!access_key || !secret_key) {\n    throw new Error('Missing Binance credential: ACCESS_KEY and SECRET_KEY must be set');\n  }\n  return { access_key, secret_key };\n};\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { GlobalPrometheusRegistry } from '@yuants/protocol';\nimport { formatTime, HmacSHA256, newError } from '@yuants/utils';\n\nconst MetricBinanceApiUsedWeight = GlobalPrometheusRegistry.gauge('binance_api_used_weight', '');\n\ntype HttpMethod = 'GET' | 'POST' | 'DELETE' | 'PUT';\n\ntype RequestParams = Record<string, string | number | boolean | undefined>;\n\nexport interface ICredential {\n  access_key: string;\n  secret_key: string;\n}\n\nexport interface IApiError {\n  code: number;\n  msg: string;\n}\n\nlet retryAfterUntil: number | null = null;\n\nexport const isApiError = <T>(value: T | IApiError): value is IApiError =>\n  typeof (value as IApiError)?.code === 'number' && typeof (value as IApiError)?.msg === 'string';\n\nconst appendParams = (url: URL, params?: RequestParams) => {\n  if (!params) return;\n  const entries = Object.entries(params).filter(([, value]) => value !== undefined);\n  const timestampEntry = entries.find(([key]) => key === 'timestamp');\n  const restEntries = entries.filter(([key]) => key !== 'timestamp');\n  restEntries\n    .sort(([keyA], [keyB]) => keyA.localeCompare(keyB))\n    .forEach(([key, value]) => {\n      url.searchParams.set(key, String(value));\n    });\n  if (timestampEntry) {\n    url.searchParams.set(timestampEntry[0], String(timestampEntry[1]));\n  }\n};\n\nconst callApi = async <T>(\n  method: HttpMethod,\n  endpoint: string,\n  params?: RequestParams,\n  credential?: ICredential,\n): Promise<T> => {\n  const url = new URL(endpoint);\n  const normalizedParams: RequestParams = { ...params };\n  if (credential) {\n    if (normalizedParams.recvWindow === undefined) {\n      // FYI https://developers.binance.com/docs/derivatives/usds-margined-futures/general-info#timing-security\n      normalizedParams.recvWindow = 5000;\n    }\n    if (normalizedParams.timestamp === undefined) {\n      normalizedParams.timestamp = Date.now();\n    }\n  }\n  appendParams(url, normalizedParams);\n\n  let headers: Record<string, string> | undefined;\n  if (credential) {\n    const signData = url.search.slice(1);\n\n    const signature = Buffer.from(\n      await HmacSHA256(new TextEncoder().encode(signData), new TextEncoder().encode(credential.secret_key)),\n    ).toString('hex');\n    url.searchParams.set('signature', signature);\n    headers = {\n      'Content-Type': 'application/json;charset=utf-8',\n      'X-MBX-APIKEY': credential.access_key,\n    };\n    console.info(\n      formatTime(Date.now()),\n      method,\n      url.href,\n      JSON.stringify(headers),\n      url.searchParams.toString(),\n      signData,\n    );\n  } else {\n    console.info(formatTime(Date.now()), method, url.href);\n  }\n\n  if (retryAfterUntil) {\n    if (Date.now() <= retryAfterUntil) {\n      throw newError('ACTIVE_RATE_LIMIT', { retryAfterUntil, now: Date.now(), url: url.href });\n    }\n    retryAfterUntil = null;\n  }\n\n  const res = await fetch(url.href, {\n    method,\n    headers,\n  });\n  const usedWeight1M = res.headers.get('x-mbx-used-weight-1m');\n  const retryAfter = res.headers.get('Retry-After');\n  if (retryAfter) {\n    retryAfterUntil = Date.now() + parseInt(retryAfter, 10) * 1000;\n  }\n  console.info(\n    formatTime(Date.now()),\n    'response',\n    method,\n    url.href,\n    `status=${res.status}`,\n    retryAfter ? `retryAfter=${retryAfter}` : '',\n    `usedWeight1M=${usedWeight1M ?? 'N/A'}`,\n  );\n  if (usedWeight1M) {\n    MetricBinanceApiUsedWeight.set(+usedWeight1M);\n  }\n  return res.json() as Promise<T>;\n};\n\nexport const requestPublic = <T>(method: HttpMethod, endpoint: string, params?: RequestParams) =>\n  callApi<T>(method, endpoint, params);\n\nexport const requestPrivate = <T>(\n  credential: ICredential,\n  method: HttpMethod,\n  endpoint: string,\n  params?: RequestParams,\n) => callApi<T>(method, endpoint, params, credential);\n\nexport const getDefaultCredential = (): ICredential => {\n  const access_key = process.env.ACCESS_KEY;\n  const secret_key = process.env.SECRET_KEY;\n  if (!access_key || !secret_key) {\n    throw new Error('Missing Binance credential: ACCESS_KEY and SECRET_KEY must be set');\n  }\n  return { access_key, secret_key };\n};\n"]}

package/dist/api/public-api.js

@@ -47,4 +47,10 @@ export const getFutureOpenInterest = (params) => requestPublic('GET', 'https://f
  * https://binance-docs.github.io/apidocs/spot/cn/#5393cd0851
  */
 export const getSpotBookTicker = (params) => requestPublic('GET', 'https://api.binance.com/api/v3/ticker/bookTicker', params);
+/**
+ * 获取现货交易规则和交易对
+ *
+ * https://developers.binance.com/docs/zh-CN/binance-spot-api-docs/rest-api/general-endpoints#%E4%BA%A4%E6%98%93%E8%A7%84%E8%8C%83%E4%BF%A1%E6%81%AF
+ */
+export const getSpotExchangeInfo = () => requestPublic('GET', 'https://api.binance.com/api/v3/exchangeInfo');
 //# sourceMappingURL=public-api.js.map

package/dist/api/public-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../../src/api/public-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAgGzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAiC,EAAE,CACtE,aAAa,CAAsB,KAAK,EAAE,+CAA+C,CAAC,CAAC;AAE7F;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAKpC,EAAsC,EAAE,CACvC,aAAa,CAA4B,KAAK,EAAE,8CAA8C,EAAE,MAAM,CAAC,CAAC;AAE1G;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA2B,EAAuC,EAAE,CACxG,aAAa,CAA6B,KAAK,EAAE,+CAA+C,EAAE,MAAM,CAAC,CAAC;AAE5G;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAA4B,EAAqC,EAAE,CACrG,aAAa,CACX,KAAK,EACL,oDAAoD,EACpD,MAAM,CACP,CAAC;AAEJ;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA0B,EAAgC,EAAE,CAChG,aAAa,CAAsB,KAAK,EAAE,+CAA+C,EAAE,MAAM,CAAC,CAAC;AASrG;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAA4B,EAAmC,EAAE,CACjG,aAAa,CAAyB,KAAK,EAAE,kDAAkD,EAAE,MAAM,CAAC,CAAC","sourcesContent":["import { requestPublic } from './client';\n\nexport interface IFutureExchangeFilter extends Record<string, string | number | boolean | undefined> {\n  filterType: string;\n}\n\nexport interface IFutureExchangeSymbol {\n  symbol: string;\n  pair: string;\n  contractType: string;\n  deliveryDate: number;\n  onboardDate: number;\n  status: string;\n  maintMarginPercent: string;\n  requiredMarginPercent: string;\n  baseAsset: string;\n  quoteAsset: string;\n  marginAsset: string;\n  pricePrecision: number;\n  quantityPrecision: number;\n  baseAssetPrecision: number;\n  quotePrecision: number;\n  underlyingType: string;\n  underlyingSubType: string[];\n  settlePlan: number;\n  triggerProtect: string;\n  liquidationFee: string;\n  marketTakeBound: string;\n  maxMoveOrderLimit: number;\n  filters: IFutureExchangeFilter[];\n  orderTypes: string[];\n  timeInForce: string[];\n}\n\nexport interface IFutureExchangeInfo {\n  timezone: string;\n  serverTime: number;\n  futuresType: string;\n  rateLimits: {\n    rateLimitType: string;\n    interval: string;\n    intervalNum: number;\n    limit: number;\n  }[];\n  exchangeFilters: unknown[];\n  assets: {\n    asset: string;\n    marginAvailable: boolean;\n    autoAssetExchange: string;\n  }[];\n  symbols: IFutureExchangeSymbol[];\n}\n\nexport interface IFutureFundingRateEntry {\n  symbol: string;\n  fundingTime: number;\n  fundingRate: string;\n  markPrice: string;\n}\n\nexport interface IFuturePremiumIndexEntry {\n  symbol: string;\n  markPrice: string;\n  indexPrice: string;\n  estimatedSettlePrice: string;\n  lastFundingRate: string;\n  interestRate: string;\n  nextFundingTime: number;\n  time: number;\n}\n\nexport interface IFutureBookTickerEntry {\n  symbol: string;\n  bidPrice: string;\n  bidQty: string;\n  askPrice: string;\n  askQty: string;\n  time: number;\n}\n\nexport interface IFutureOpenInterest {\n  openInterest: string;\n  symbol: string;\n  time: number;\n}\n\nexport interface IMarginPair {\n  id: string;\n  symbol: string;\n  base: string;\n  quote: string;\n  isMarginTrade: boolean;\n  isBuyAllowed: boolean;\n  isSellAllowed: boolean;\n}\n\n/**\n * 获取交易规则和交易对\n *\n * https://binance-docs.github.io/apidocs/futures/cn/#0f3f2d5ee7\n */\nexport const getFutureExchangeInfo = (): Promise<IFutureExchangeInfo> =>\n  requestPublic<IFutureExchangeInfo>('GET', 'https://fapi.binance.com/fapi/v1/exchangeInfo');\n\n/**\n * 查询资金费率历史\n *\n * https://binance-docs.github.io/apidocs/futures/cn/#31dbeb24c4\n */\nexport const getFutureFundingRate = (params: {\n  symbol?: string;\n  startTime?: number;\n  endTime?: number;\n  limit?: number;\n}): Promise<IFutureFundingRateEntry[]> =>\n  requestPublic<IFutureFundingRateEntry[]>('GET', 'https://fapi.binance.com/fapi/v1/fundingRate', params);\n\n/**\n * 最新标记价格和资金费率\n *\n * 采集各大交易所数据加权平均\n *\n * 权重: 带symbol为1；不带symbol为10\n *\n * https://developers.binance.com/docs/zh-CN/derivatives/usds-margined-futures/market-data/rest-api/Mark-Price\n */\nexport const getFuturePremiumIndex = (params: { symbol?: string }): Promise<IFuturePremiumIndexEntry[]> =>\n  requestPublic<IFuturePremiumIndexEntry[]>('GET', 'https://fapi.binance.com/fapi/v1/premiumIndex', params);\n\n/**\n * 当前最优挂单\n *\n * 返回当前最优的挂单(最高买单，最低卖单)\n *\n * 权重: 单交易对2，无交易对5\n *\n * https://developers.binance.com/docs/zh-CN/derivatives/usds-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker\n */\nexport const getFutureBookTicker = (params?: { symbol?: string }): Promise<IFutureBookTickerEntry[]> =>\n  requestPublic<IFutureBookTickerEntry[]>(\n    'GET',\n    'https://fapi.binance.com/fapi/v1/ticker/bookTicker',\n    params,\n  );\n\n/**\n * 获取未平仓合约数\n *\n * 权重: 1\n *\n * 更新速率: 3s\n *\n * https://developers.binance.com/docs/zh-CN/derivatives/usds-margined-futures/market-data/rest-api/Open-Interest\n */\nexport const getFutureOpenInterest = (params: { symbol: string }): Promise<IFutureOpenInterest> =>\n  requestPublic<IFutureOpenInterest>('GET', 'https://fapi.binance.com/fapi/v1/openInterest', params);\nexport interface ISpotBookTickerEntry {\n  symbol: string;\n  bidPrice: string;\n  bidQty: string;\n  askPrice: string;\n  askQty: string;\n}\n\n/**\n * 当前最优挂单 (Spot)\n *\n * https://binance-docs.github.io/apidocs/spot/cn/#5393cd0851\n */\nexport const getSpotBookTicker = (params?: { symbol?: string }): Promise<ISpotBookTickerEntry[]> =>\n  requestPublic<ISpotBookTickerEntry[]>('GET', 'https://api.binance.com/api/v3/ticker/bookTicker', params);\n"]}
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../../src/api/public-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAgGzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAiC,EAAE,CACtE,aAAa,CAAsB,KAAK,EAAE,+CAA+C,CAAC,CAAC;AAE7F;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAKpC,EAAsC,EAAE,CACvC,aAAa,CAA4B,KAAK,EAAE,8CAA8C,EAAE,MAAM,CAAC,CAAC;AAE1G;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA2B,EAAuC,EAAE,CACxG,aAAa,CAA6B,KAAK,EAAE,+CAA+C,EAAE,MAAM,CAAC,CAAC;AAE5G;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAA4B,EAAqC,EAAE,CACrG,aAAa,CACX,KAAK,EACL,oDAAoD,EACpD,MAAM,CACP,CAAC;AAEJ;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA0B,EAAgC,EAAE,CAChG,aAAa,CAAsB,KAAK,EAAE,+CAA+C,EAAE,MAAM,CAAC,CAAC;AASrG;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAA4B,EAAmC,EAAE,CACjG,aAAa,CAAyB,KAAK,EAAE,kDAAkD,EAAE,MAAM,CAAC,CAAC;AAwC3G;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAA+B,EAAE,CAClE,aAAa,CAAoB,KAAK,EAAE,6CAA6C,CAAC,CAAC","sourcesContent":["import { requestPublic } from './client';\n\nexport interface IFutureExchangeFilter extends Record<string, string | number | boolean | undefined> {\n  filterType: string;\n}\n\nexport interface IFutureExchangeSymbol {\n  symbol: string;\n  pair: string;\n  contractType: string;\n  deliveryDate: number;\n  onboardDate: number;\n  status: string;\n  maintMarginPercent: string;\n  requiredMarginPercent: string;\n  baseAsset: string;\n  quoteAsset: string;\n  marginAsset: string;\n  pricePrecision: number;\n  quantityPrecision: number;\n  baseAssetPrecision: number;\n  quotePrecision: number;\n  underlyingType: string;\n  underlyingSubType: string[];\n  settlePlan: number;\n  triggerProtect: string;\n  liquidationFee: string;\n  marketTakeBound: string;\n  maxMoveOrderLimit: number;\n  filters: IFutureExchangeFilter[];\n  orderTypes: string[];\n  timeInForce: string[];\n}\n\nexport interface IFutureExchangeInfo {\n  timezone: string;\n  serverTime: number;\n  futuresType: string;\n  rateLimits: {\n    rateLimitType: string;\n    interval: string;\n    intervalNum: number;\n    limit: number;\n  }[];\n  exchangeFilters: unknown[];\n  assets: {\n    asset: string;\n    marginAvailable: boolean;\n    autoAssetExchange: string;\n  }[];\n  symbols: IFutureExchangeSymbol[];\n}\n\nexport interface IFutureFundingRateEntry {\n  symbol: string;\n  fundingTime: number;\n  fundingRate: string;\n  markPrice: string;\n}\n\nexport interface IFuturePremiumIndexEntry {\n  symbol: string;\n  markPrice: string;\n  indexPrice: string;\n  estimatedSettlePrice: string;\n  lastFundingRate: string;\n  interestRate: string;\n  nextFundingTime: number;\n  time: number;\n}\n\nexport interface IFutureBookTickerEntry {\n  symbol: string;\n  bidPrice: string;\n  bidQty: string;\n  askPrice: string;\n  askQty: string;\n  time: number;\n}\n\nexport interface IFutureOpenInterest {\n  openInterest: string;\n  symbol: string;\n  time: number;\n}\n\nexport interface IMarginPair {\n  id: string;\n  symbol: string;\n  base: string;\n  quote: string;\n  isMarginTrade: boolean;\n  isBuyAllowed: boolean;\n  isSellAllowed: boolean;\n}\n\n/**\n * 获取交易规则和交易对\n *\n * https://binance-docs.github.io/apidocs/futures/cn/#0f3f2d5ee7\n */\nexport const getFutureExchangeInfo = (): Promise<IFutureExchangeInfo> =>\n  requestPublic<IFutureExchangeInfo>('GET', 'https://fapi.binance.com/fapi/v1/exchangeInfo');\n\n/**\n * 查询资金费率历史\n *\n * https://binance-docs.github.io/apidocs/futures/cn/#31dbeb24c4\n */\nexport const getFutureFundingRate = (params: {\n  symbol?: string;\n  startTime?: number;\n  endTime?: number;\n  limit?: number;\n}): Promise<IFutureFundingRateEntry[]> =>\n  requestPublic<IFutureFundingRateEntry[]>('GET', 'https://fapi.binance.com/fapi/v1/fundingRate', params);\n\n/**\n * 最新标记价格和资金费率\n *\n * 采集各大交易所数据加权平均\n *\n * 权重: 带symbol为1；不带symbol为10\n *\n * https://developers.binance.com/docs/zh-CN/derivatives/usds-margined-futures/market-data/rest-api/Mark-Price\n */\nexport const getFuturePremiumIndex = (params: { symbol?: string }): Promise<IFuturePremiumIndexEntry[]> =>\n  requestPublic<IFuturePremiumIndexEntry[]>('GET', 'https://fapi.binance.com/fapi/v1/premiumIndex', params);\n\n/**\n * 当前最优挂单\n *\n * 返回当前最优的挂单(最高买单，最低卖单)\n *\n * 权重: 单交易对2，无交易对5\n *\n * https://developers.binance.com/docs/zh-CN/derivatives/usds-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker\n */\nexport const getFutureBookTicker = (params?: { symbol?: string }): Promise<IFutureBookTickerEntry[]> =>\n  requestPublic<IFutureBookTickerEntry[]>(\n    'GET',\n    'https://fapi.binance.com/fapi/v1/ticker/bookTicker',\n    params,\n  );\n\n/**\n * 获取未平仓合约数\n *\n * 权重: 1\n *\n * 更新速率: 3s\n *\n * https://developers.binance.com/docs/zh-CN/derivatives/usds-margined-futures/market-data/rest-api/Open-Interest\n */\nexport const getFutureOpenInterest = (params: { symbol: string }): Promise<IFutureOpenInterest> =>\n  requestPublic<IFutureOpenInterest>('GET', 'https://fapi.binance.com/fapi/v1/openInterest', params);\nexport interface ISpotBookTickerEntry {\n  symbol: string;\n  bidPrice: string;\n  bidQty: string;\n  askPrice: string;\n  askQty: string;\n}\n\n/**\n * 当前最优挂单 (Spot)\n *\n * https://binance-docs.github.io/apidocs/spot/cn/#5393cd0851\n */\nexport const getSpotBookTicker = (params?: { symbol?: string }): Promise<ISpotBookTickerEntry[]> =>\n  requestPublic<ISpotBookTickerEntry[]>('GET', 'https://api.binance.com/api/v3/ticker/bookTicker', params);\n\nexport interface ISpotExchangeFilter extends Record<string, string | number | boolean | undefined> {\n  filterType: string;\n}\n\nexport interface ISpotExchangeSymbol {\n  symbol: string;\n  status: string;\n  baseAsset: string;\n  baseAssetPrecision: number;\n  quoteAsset: string;\n  quotePrecision: number;\n  baseCommissionPrecision: number;\n  quoteCommissionPrecision: number;\n  orderTypes: string[];\n  icebergAllowed: boolean;\n  ocoAllowed: boolean;\n  quoteOrderQtyMarketAllowed: boolean;\n  allowTrailingStop: boolean;\n  cancelReplaceAllowed: boolean;\n  isSpotTradingAllowed: boolean;\n  isMarginTradingAllowed: boolean;\n  filters: ISpotExchangeFilter[];\n  permissions: string[];\n}\n\nexport interface ISpotExchangeInfo {\n  timezone: string;\n  serverTime: number;\n  rateLimits: {\n    rateLimitType: string;\n    interval: string;\n    intervalNum: number;\n    limit: number;\n  }[];\n  exchangeFilters: unknown[];\n  symbols: ISpotExchangeSymbol[];\n}\n\n/**\n * 获取现货交易规则和交易对\n *\n * https://developers.binance.com/docs/zh-CN/binance-spot-api-docs/rest-api/general-endpoints#%E4%BA%A4%E6%98%93%E8%A7%84%E8%8C%83%E4%BF%A1%E6%81%AF\n */\nexport const getSpotExchangeInfo = (): Promise<ISpotExchangeInfo> =>\n  requestPublic<ISpotExchangeInfo>('GET', 'https://api.binance.com/api/v3/exchangeInfo');\n"]}

package/dist/index.js

@@ -2,6 +2,5 @@ import './public-data/interest_rate';
 import './public-data/ohlc';
 import './public-data/product';
 import './public-data/quote';
-import './services/account-actions-with-credential';
-import './services/order-actions-with-credential';
+import './services/exchange';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,6BAA6B,CAAC;AACrC,OAAO,oBAAoB,CAAC;AAC5B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,4CAA4C,CAAC;AACpD,OAAO,0CAA0C,CAAC","sourcesContent":["import './public-data/interest_rate';\nimport './public-data/ohlc';\nimport './public-data/product';\nimport './public-data/quote';\nimport './services/account-actions-with-credential';\nimport './services/order-actions-with-credential';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,6BAA6B,CAAC;AACrC,OAAO,oBAAoB,CAAC;AAC5B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,qBAAqB,CAAC","sourcesContent":["import './public-data/interest_rate';\nimport './public-data/ohlc';\nimport './public-data/product';\nimport './public-data/quote';\nimport './services/exchange';\n"]}