# LivePPP — US & China A-Share Market Data API

> Read-only daily market data for AI agents and developers: finalized US
> equities/ETF and China A-share daily bars (OHLCV), SMA / Wilder RSI(14)
> indicators, trading calendars, dataset status and corporate flash news.
> REST and MCP (streamable HTTP) expose the same tools. Requests without
> an API key automatically use a rate-limited demo tier; a free API key
> unlocks plan quota.

## Entry points

- API base: https://api.liveppp.com
- MCP endpoint: https://api.liveppp.com/mcp
- OpenAPI document: https://api.liveppp.com/openapi.json
- Agent skill (install + usage instructions): https://liveppp.com/skill.md
- Human documentation: https://liveppp.com/docs
- Console (API keys, usage): https://app.liveppp.com

## Core endpoints

- GET /v1/bars?market=US|CN&symbol=NVDA&limit=60 — latest finalized daily bars
- GET /v1/history — historical daily bars
- GET /v1/indicators?market=US|CN&symbol=NVDA — SMA(period), RSI14, 1d/20d returns
- GET /v1/instruments/search?market=US|CN&q=NVDA — search the live universe
- GET /v1/calendar?market=US|CN — trading sessions (XNYS / XSHG)
- GET /v1/datasets/status?market=US|CN — published coverage and freshness
- GET /v1/news/flash — corporate filings and market flash news

## Notes for agents

- A-share symbols carry an exchange prefix: SH600519, SZ300750, SZ000001.
- Prices are daily bars for finalized sessions; every response carries
  its trade dates (data_as_of, available_start, available_end).
- Auth: `Authorization: Bearer <api key>`. No key = demo tier
  (per-IP limits, bars <= 60 per request). An invalid key returns 401.
- Data is read-only; the API never places orders or moves funds.