A-Share Data in Node.js / TypeScript with the Official SDK

npm install ashareapi
# or: pnpm add ashareapi / yarn add ashareapi

import { AShareAPI } from "ashareapi";

const cli = new AShareAPI();                  // free endpoints need no key
const bars = await cli.quote("sh600667");     // real-time quote
console.log(bars[0]);                         // { date, open, last, high, low, volume, amount, turnover }

console.log(await cli.kline("600667.SH", "day", 5));  // any symbol format works
console.log(await cli.hot(10));                       // hot list
console.log(await cli.changedist());                  // up/down distribution

const { AShareAPI } = require("ashareapi");

(async () => {
  const cli = new AShareAPI();
  const rows = await cli.kline("sh600667", "day", 3);
  console.log(rows[0].date, rows[0].last);
})();

import { AShareAPI } from "ashareapi";

const cli = new AShareAPI({ apiKey: "ct-your-key" });   // or set ASHARE_API_KEY
const rows = await cli.screen("", "low_pe", 10, "ROETTM");  // expr, preset, limit, orderby
console.table(rows);

console.log(await cli.fund("sh600667"));      // money flow + boards + block trades + margin
console.log(await cli.finance("sh600667"));   // three financial statements
console.log(await cli.lhb("institution"));    // top-trader board, institutions

const rows = await cli.kline("sh600667", "day", 3);
// [
//   { date: '2026-09-23', open: '20.10', last: '20.59', high: '20.72', low: '19.45', ... },
//   { date: '2026-09-22', open: '20.63', last: '19.87', ... },
//   { date: '2026-09-21', ... }
// ]

import { AShareAPI, AuthError, RateLimitError,
         UpstreamError, EmptyResultError } from "ashareapi";

const cli = new AShareAPI();
try {
  const rows = await cli.fund("sh600667");
} catch (e) {
  if (e instanceof AuthError) console.log(e.message);          // 401 -> key-required endpoint, get a key
  else if (e instanceof RateLimitError) console.log(e.message); // 429 -> slow down / solve a PoW challenge / upgrade
  else if (e instanceof UpstreamError) console.log(e.message);  // upstream fetch failed (failed over, not billed) -> retry once
  else if (e instanceof EmptyResultError) console.log(e.message); // no data right now (e.g. no block trades today) -> not billed
  else throw e;
}

import { NextResponse } from "next/server";
import { AShareAPI, AuthError, RateLimitError } from "ashareapi";

const cli = new AShareAPI();   // reads process.env.ASHARE_API_KEY

export async function GET(request: Request) {
  const code = new URL(request.url).searchParams.get("code") ?? "sh600667";
  try {
    const [quote, technical] = await Promise.all([cli.quote(code), cli.technical(code)]);
    return NextResponse.json({ ok: true, code, quote: quote[0], technical: technical[0] });
  } catch (e) {
    if (e instanceof AuthError) return NextResponse.json({ ok: false, error: "Missing or invalid key" }, { status: 401 });
    if (e instanceof RateLimitError) return NextResponse.json({ ok: false, error: "Rate limited" }, { status: 429 });
    throw e;
  }
}