photonichat · quote APIFastAPI

Live markets

Hyperliquid live WS + Sina · browser↔server WS …

warming up the live feed…

News

world · business · tech · crypto — merged & deduped, newest first

loading headlines…

Settingsedit the homepage markets — shared for everyone · password to save

Featured chartstop finviz-style charts · Hyperliquid tickers Live marketsHyperliquid tickers, comma-separated Sina / A-sharesSina codes · e.g. sh600519, hk00700, gb_aapl, fx_susdcny Category orderdrag to reorder the Live-markets groups · default: Equities first

Passwordrequired to save the shared config

About

A tiny FastAPI quote-proxy for the photonichat ESP32 clock — global equities, FX, futures, metals, crypto and Hyperliquid live markets (crypto perps + tokenized equities, commodities, FX & indices), all in one JSON shape.

Sources: Hyperliquid · Sina Finance · CoinGecko · eToro · open-meteo. Interactive API docs at /docs · device integration guide for building a client.

Watchlist

shared lists · saved on the server · visible & editable by everyone · ☆ any market to add

eToro markets

browse 15,000+ instruments — stocks, crypto, ETFs, commodities, FX & indices

loading eToro markets…

Endpoints

Read-only HTTP GET, no auth, CORS-open, JSON (CSV/WS where noted).

Method	Path	Returns	Try it
GET	`/q/{symbol}`	Single-symbol JSON quote	sh600519 · hk00700 · gb_aapl
GET	`/q?syms=A,B,C`	Batch JSON (one upstream request)	/q?syms=…
GET	`/quote/{symbol}`	Full quote: name, price, change, change_pct, currency, exchange, ts	/quote/sh600519
GET	`/metals`	Gold + silver USD/oz	/metals
GET	`/crypto?ids=…`	CoinGecko USD prices + 24h change	/crypto
GET	`/clock?stocks=…&coins=…`	One-shot bundle: stocks + metals + crypto	/clock
GET	`/symbols` · `/symbols/search`	Curated catalog + full A-share universe search	/symbols · search 茅台
Hyperliquid · live markets & WS hub
GET	`/hl/markets?q=&category=&dex=`	Browse/search every HL market (crypto, equities, commodities, FX, indices) with price + 24h change	equities · commodities
GET	`/hl/search?q=…`	Substring search across HL markets (ranked by liquidity)	nvda · gold
GET	`/hl/quotes?syms=…`	Enriched quotes + change% — friendly aliases (`NVDAUSDT`→`xyz:NVDA`)	BTC,ETH,NVDA,MU,GOLD,SP500
GET	`/hl/{coin}`	CSV `COIN,price,ts` (ESP32-friendly; equities work too)	/hl/BTC · /hl/NVDA
GET	`/hl?syms=A,B,C`	Batch live mids from the WS hub	BTC,ETH,SOL
WS	`/hl/ws`	Fan-out proxy for `wss://api.hyperliquid.xyz/ws`	WS client
GET	`/hl/book/{coin}` · `/hl/trades/{coin}` · `/hl/candle/{coin}/{iv}`	L2 book · last trades · latest candle (from the WS hub)	book · trades · candle
GET	`/hl/candles/{coin}?interval=&limit=`	OHLCV candle series (powers the homepage charts; builder-dex names auto-resolved)	BTC 1h · GOLD 1d
GET	`/hl/stats`	Hub + markets-catalog diagnostics	/hl/stats
eToro · ~15k markets (public market-data CDN)
GET	`/etoro/markets?q=&category=&page=`	Browse every eToro market (crypto, stocks, ETFs, commodities, FX, indices) with last close + weekly change	crypto · stocks
GET	`/etoro/search?q=…`	Substring search across all eToro instruments	apple · tesla
GET	`/etoro/quotes?syms=…`	Enriched quotes + daily change% — accepts ticker, instrument id, or name	AAPL,BTC,GOLD,TSLA
GET	`/etoro/candles/{symbol}?interval=&limit=`	OHLC candle series (powers the eToro charts)	AAPL 1d · BTC 1h
GET	`/etoro/stats`	eToro catalog diagnostics	/etoro/stats
GET	`/news?sym=…` · `/news?syms=A,B`	per-instrument news (Google-News RSS, merged across `syms`)	/news?sym=NVDA
GET	`/news/general?topic=&lang=&limit=`	merged world/business/tech headlines (multi-source, deduped, newest-first)	/news/general?topic=business

Hyperliquid market search

The catalog polls the Hyperliquid info endpoint across the core perp dex and every HIP-3 builder dex, so you can discover and quote far more than crypto: tokenized equities (NVDA, MU, TSLA, AAPL, COIN, MSTR…), commodities (GOLD, SILVER, CL…), FX (EUR, JPY, DXY…) and indices (SP500, JP225, VIX…). Use the search box above or /hl/markets. Friendly aliases are accepted: NVDAUSDT, nvda and xyz:NVDA all resolve to the same market.

Symbol formats (Sina / CoinGecko)

Native hq.sinajs.cn codes work as-is; Yahoo-style aliases are auto-translated.

Market	Native code	Alias accepted
Shanghai A-share	`sh600519`	`600519.SS`
Shenzhen A-share	`sz000001`	`000001.SZ`
Hong Kong	`hk00700`	`0700.HK`
US stock	`gb_aapl`	`AAPL`
Index (intl)	`int_sp500`, `int_nasdaq`	`^GSPC`, `^IXIC`
Forex	`fx_susdcny`	`USDCNY=X`
NYMEX future	`hf_GC`, `hf_CL`	`GC=F`, `CL=F`
Spot metal	`hf_XAU`, `hf_XAG`	`XAUUSD`, `XAGUSD`

Full A-share universe

loading universe…

browse SH · browse SZ · browse BJ · browse all — or use the search box at the top (Chinese names work, e.g. 茅台). Cached to disk for 7 days; refresh via /symbols/reload.

Curated catalog

Hand-picked highlights across markets. Full list as JSON: /symbols.

A-shares (Shanghai) · 8 symbols

Symbol	Name
`sh600000`	Pudong Development Bank
`sh600036`	China Merchants Bank
`sh600519`	Kweichow Moutai
`sh600490`	Penghui Energy
`sh601318`	Ping An Insurance
`sh601398`	ICBC
`sh601857`	PetroChina
`sh688981`	SMIC (STAR Market)

A-shares (Shenzhen) · 8 symbols

Symbol	Name
`sz000001`	Ping An Bank
`sz000002`	Vanke
`sz000333`	Midea Group
`sz000651`	Gree Electric
`sz000725`	BOE Technology
`sz000858`	Wuliangye
`sz300750`	CATL
`sz300760`	Mindray Medical

Hong Kong · 9 symbols

Symbol	Name
`hk00700`	Tencent
`hk00939`	CCB
`hk00941`	China Mobile
`hk01024`	Kuaishou
`hk01299`	AIA
`hk01810`	Xiaomi
`hk03690`	Meituan
`hk09988`	Alibaba
`hk09618`	JD.com

US stocks (gb_) · 12 symbols

Symbol	Name
`gb_aapl`	Apple
`gb_msft`	Microsoft
`gb_googl`	Alphabet
`gb_amzn`	Amazon
`gb_nvda`	NVIDIA
`gb_tsla`	Tesla
`gb_meta`	Meta
`gb_nflx`	Netflix
`gb_amd`	AMD
`gb_baba`	Alibaba ADR
`gb_pdd`	PDD Holdings
`gb_nio`	NIO

Indices · 10 symbols

Symbol	Name
`sh000001`	Shanghai Composite
`sz399001`	Shenzhen Component
`sz399006`	ChiNext
`sh000300`	CSI 300
`int_sp500`	S&P 500
`int_nasdaq`	Nasdaq Composite
`int_dji`	Dow Jones
`int_hangseng`	Hang Seng
`int_nikkei`	Nikkei 225
`int_ftse`	FTSE 100

Forex (fx_) · 8 symbols

Symbol	Name
`fx_susdcny`	USD/CNY
`fx_susdhkd`	USD/HKD
`fx_susdjpy`	USD/JPY
`fx_seurusd`	EUR/USD
`fx_sgbpusd`	GBP/USD
`fx_saudusd`	AUD/USD
`fx_susdsgd`	USD/SGD
`fx_susdkrw`	USD/KRW

Commodity futures (NYMEX, hf_) · 9 symbols

Symbol	Name
`hf_GC`	Gold (NY)
`hf_SI`	Silver (NY)
`hf_CL`	WTI Crude Oil
`hf_NG`	Natural Gas
`hf_HG`	Copper
`hf_PL`	Platinum
`hf_PA`	Palladium
`hf_XAU`	Spot Gold (XAUUSD)
`hf_XAG`	Spot Silver (XAGUSD)

Crypto (CoinGecko ids) · 7 symbols

Symbol	Name
`bitcoin`	BTC
`ethereum`	ETH
`solana`	SOL
`binancecoin`	BNB
`ripple`	XRP
`cardano`	ADA
`dogecoin`	DOGE

Agent / ESP32 integration

Everything is read-only GET, no auth, CORS-open, JSON. Rules for an AI or embedded client:

Batch. Need several symbols? Use /q?syms=…, /clock, or /hl/quotes?syms=… — never loop single requests.
Poll ≥30s. Quotes cache 30s, metals 60s, crypto 300s (5 min; on upstream 429 it serves the last good prices and backs off 120s before retrying); Hyperliquid catalog refreshes ~20s.
Discovery. A-shares → /symbols/search?q=… (accepts Chinese); Hyperliquid → /hl/search?q=…. Send the user's symbol as-is — the server normalizes Yahoo-style aliases and HL tickers automatically.
404 = "no quote", not an error to retry.

# every quote object shares one shape:
GET /quote/gb_nvda
GET /q?syms=sh600519,hk00700,gb_aapl,int_sp500
GET /clock?stocks=gb_aapl,gb_tsla&coins=bitcoin,ethereum
GET /hl/quotes?syms=BTC,ETH,NVDA,MU,GOLD       # Hyperliquid, with change%
GET /hl/NVDA                                    # -> NVDA,228.85,1780396053  (CSV)
GET /symbols/search?q=茅台