warming up the live feed…
loading headlines…
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.
loading eToro markets…
Read-only HTTP GET, no auth, CORS-open, JSON (CSV/WS where noted).
| Method | Path | Returns | Try it |
|---|---|---|---|
Unified API /api/v1 · just pass a name — we smart-route the feed | |||
| GET | /api/v1/q/{name} |
One quote, any market. Pass a plain instrument name — we resolve it to its best live feed (Hyperliquid / Sina / eToro). One JSON shape for everything. | usdjpy · btc · aapl · 600519 · gold |
| GET | /api/v1/q?syms=A,B,C |
Batch — each name resolved independently (mix any markets) | btc,usdjpy,aapl,600519,gold,sp500 |
| WS | /api/v1/ws |
Live stream — {"op":"subscribe","syms":["btc","usdjpy"]}; we push {"channel":"quotes","data":[…]} snapshots every ~3s |
WS client |
| Native per-feed routes (still available; the unified API wraps these) | |||
| 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 |
/api/v1 — one name in, best live quote outDon't make the caller learn a different route per market. Pass a plain
instrument name to /api/v1/q/{name} (or a list to /api/v1/q?syms=…,
or subscribe over /api/v1/ws) and we resolve it to the best live feed we
carry. Hyperliquid is live 24/7, Sina is live during market hours, eToro is the daily-close
fallback. Every response is the same JSON shape regardless of upstream:
GET /api/v1/q/usdjpy
{
"input": "usdjpy", "symbol": "FX_SUSDJPY", "name": "美元日元",
"price": 157.23, "change": 0.41, "change_pct": 0.261, "change_basis": "1d",
"currency": "", "category": "fx", "feed": "Sina", "live": true,
"hours": "", "icon": null, "ts": 1749999999, "ts_utc": "2026-06-12T…Z"
}
Routing table (first match that returns a price wins):
| If the name looks like… | Example | Feed | Liveness |
|---|---|---|---|
| a 6-letter FX pair | usdjpy, eurusd | Sina fx_s… | live 24/5 |
| an A-share code / Chinese name | 600519, sh600519, 茅台 | Sina | live (CN hours) |
| a Hong Kong code | hk00700, 0700.HK | Sina | live (HK hours) |
| listed on Hyperliquid | btc, nvda, gold, sp500 | Hyperliquid | live 24/7 |
| maps to a Sina code | aapl, gc, ^gspc | Sina | live |
| listed on eToro (anything else) | ~15k stocks / ETFs / funds | eToro | daily close |
Stream (/api/v1/ws). Subscribe by name and get pushed snapshots:
// client → server
{"op":"subscribe","syms":["btc","usdjpy","aapl","600519"]}
{"op":"unsubscribe","syms":["aapl"]}
{"op":"ping"}
// server → client
{"channel":"ack","op":"subscribe","syms":["600519","aapl","btc","usdjpy"]}
{"channel":"quotes","data":[ /* same objects as /api/v1/q */ ],"ts":…}
{"channel":"pong"}
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.
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 |
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.
Hand-picked highlights across markets. Full list as JSON: /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) |
| Symbol | Name |
|---|---|
sz000001 | Ping An Bank |
sz000002 | Vanke |
sz000333 | Midea Group |
sz000651 | Gree Electric |
sz000725 | BOE Technology |
sz000858 | Wuliangye |
sz300750 | CATL |
sz300760 | Mindray Medical |
| Symbol | Name |
|---|---|
hk00700 | Tencent |
hk00939 | CCB |
hk00941 | China Mobile |
hk01024 | Kuaishou |
hk01299 | AIA |
hk01810 | Xiaomi |
hk03690 | Meituan |
hk09988 | Alibaba |
hk09618 | JD.com |
| 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 |
| 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 |
| 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 |
| 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) |
| Symbol | Name |
|---|---|
bitcoin | BTC |
ethereum | ETH |
solana | SOL |
binancecoin | BNB |
ripple | XRP |
cardano | ADA |
dogecoin | DOGE |
Everything is read-only GET, no auth, CORS-open, JSON. Rules for an AI or embedded client:
/q?syms=…, /clock, or
/hl/quotes?syms=… — never loop single requests./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.# 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=茅台