These endpoints serve public data. They are read-only, CORS-enabled, and do not
require authentication. Authenticated endpoints (alerts, positions, config) live
behind /api/* and require a session cookie or Bearer key from a
Pro/Business account.
GET /api/public/market-pulse
GET/api/public/market-pulse
Live crypto tickers, macro context, and the current USD/PHP rate. Cached for 25
seconds at the edge. Best used for a landing-page ticker, a status widget, or a
dashboard sidebar.
curl -s https://market.nythosx.com/api/public/market-pulse | jq
{
"crypto": [
{ "key": "btc", "label": "BTC", "price": 67842.10, "changePct": -1.24 },
{ "key": "eth", "label": "ETH", "price": 3412.55, "changePct": 0.82 },
...
],
"macro": [
{ "key": "dxy", "label": "DXY", "value": 104.28, "changePct": 0.21, "unit": "" },
{ "key": "vix", "label": "VIX", "value": 14.62, "changePct": -2.10, "unit": "" },
...
],
"forex": [
{ "key": "usdphp", "label": "USD/PHP", "price": 58.421, "changePct": null }
],
"ts": 1770000000000
}
GET /api/public/candles
GET/api/public/candles?symbol=BTCUSDT&tf=24H
OHLCV candle series for a whitelisted crypto symbol. Cached for 60 seconds.
Suitable for a sparkline, a mini chart, or an offline backtest feed.
- symbol BTCUSDT, ETHUSDT, SOLUSDT, BNBUSDT, XRPUSDT, ADAUSDT, DOGEUSDT, AVAXUSDT, LINKUSDT, LTCUSDT, MATICUSDT, DOTUSDT
- tf 1H, 24H, 7D, 30D, 1Y (default: 24H)
curl -s "https://market.nythosx.com/api/public/candles?symbol=BTCUSDT&tf=24H" | jq
[
{ "time": 1769990400, "open": 67120.10, "high": 67950.00, "low": 66890.20, "close": 67842.10, "volume": 1823.44 },
...
]
Authenticated endpoints
Everything else — alerts, positions, watchlist config, advisor reads, backtest
runs, shadow trades — requires a session cookie (from
POST /api/auth/login) or a Bearer key generated at
/account. Pro and Business tiers can create up to 5 and 50 keys
respectively. Keys are shown exactly once at creation and stored hashed at rest.
- GET /api/state — full dashboard state (config, prices, positions, indicators, macro)
- POST /api/refresh — force a check pass; returns the new state
- GET /api/candles?key=&tf= — instrument candles including stocks and forex
- GET /api/analyst — portfolio analyst report with health verdict and insights
- GET /api/tutor/now?key=&tf= — Advisor verdict for a specific instrument and timeframe
- POST /api/backtest — run a strategy backtest against stored OHLCV
- GET /api/shadow/state — virtual-capital trades, stats, and decisions
- GET /api/advisor/accuracy — calibration report across all graded verdicts
Terms of use
Public endpoints are free to use, including from other websites, but please cache
responses client-side — do not poll faster than once every 25 seconds. Bulk
scraping, resale, or use to build a competing product is prohibited. See
the terms for details.
If you build something interesting on top of these endpoints, email
support@nythosx.com and we
will link to it from this page.