{"name":"Tradestar Edge API","version":"v1","status":"Beta","baseUrl":"https://console.tradestar.app/api/edge/v1","description":"Read-only, programmatic access to Tradestar's Market Edge data: historical session records and discovered edges, as JSON.","auth":{"header":"Authorization","scheme":"Bearer <key>","note":"Required on every endpoint except this one. Generate a personal key in Settings → Account → Edge API."},"instruments":[{"key":"XAUUSD","label":"Gold","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"XAGUSD","label":"Silver","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"XCUUSD","label":"Copper","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"NAS100","label":"Nasdaq 100","sessions":["NY","FULL","LONDON","ASIAN"],"defaultSession":"NY"},{"key":"US500","label":"S&P 500","sessions":["NY","FULL","LONDON","ASIAN"],"defaultSession":"NY"},{"key":"US30","label":"Dow 30","sessions":["NY","FULL","LONDON","ASIAN"],"defaultSession":"NY"},{"key":"US2000","label":"Russell 2000","sessions":["NY","FULL","LONDON","ASIAN"],"defaultSession":"NY"},{"key":"AUDJPY","label":"AUD/JPY","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"AUDUSD","label":"AUD/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"EURCHF","label":"EUR/CHF","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"EURGBP","label":"EUR/GBP","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"EURJPY","label":"EUR/JPY","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"EURUSD","label":"EUR/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"GBPJPY","label":"GBP/JPY","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"GBPUSD","label":"GBP/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"NZDUSD","label":"NZD/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"USDCAD","label":"USD/CAD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"USDCHF","label":"USD/CHF","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"USDCNH","label":"USD/CNH","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"USDJPY","label":"USD/JPY","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"USDMXN","label":"USD/MXN","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"ADAUSD","label":"ADA/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"BCHUSD","label":"BCH/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"BTCUSD","label":"BTC/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"ETHUSD","label":"ETH/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"LTCUSD","label":"LTC/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"TRXUSD","label":"TRX/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"XLMUSD","label":"XLM/USD","sessions":["FULL","NY","LONDON","ASIAN"],"defaultSession":"FULL"},{"key":"AAPL","label":"AAPL","sessions":["NY"],"defaultSession":"NY"},{"key":"AMD","label":"AMD","sessions":["NY"],"defaultSession":"NY"},{"key":"AMZN","label":"AMZN","sessions":["NY"],"defaultSession":"NY"},{"key":"AVGO","label":"AVGO","sessions":["NY"],"defaultSession":"NY"},{"key":"FB","label":"FB","sessions":["NY"],"defaultSession":"NY"},{"key":"GOOG","label":"GOOG","sessions":["NY"],"defaultSession":"NY"},{"key":"GOOGL","label":"GOOGL","sessions":["NY"],"defaultSession":"NY"},{"key":"JPM","label":"JPM","sessions":["NY"],"defaultSession":"NY"},{"key":"MSFT","label":"MSFT","sessions":["NY"],"defaultSession":"NY"},{"key":"NFLX","label":"NFLX","sessions":["NY"],"defaultSession":"NY"},{"key":"NVDA","label":"NVDA","sessions":["NY"],"defaultSession":"NY"},{"key":"PLTR","label":"PLTR","sessions":["NY"],"defaultSession":"NY"},{"key":"QQQ","label":"QQQ","sessions":["NY"],"defaultSession":"NY"},{"key":"SPY","label":"SPY","sessions":["NY"],"defaultSession":"NY"},{"key":"TSLA","label":"TSLA","sessions":["NY"],"defaultSession":"NY"},{"key":"V","label":"V","sessions":["NY"],"defaultSession":"NY"},{"key":"WMT","label":"WMT","sessions":["NY"],"defaultSession":"NY"}],"sessions":[{"key":"NY","label":"New York (RTH)"},{"key":"LONDON","label":"London"},{"key":"ASIAN","label":"Asian"},{"key":"FULL","label":"Daily"}],"reports":[{"key":"gap-fill","label":"Gap Fill","category":"Gap & Open"},{"key":"gap-day-direction","label":"Gap → Day Direction","category":"Gap & Open"},{"key":"outside-day","label":"Outside Day","category":"Gap & Open"},{"key":"initial-balance","label":"Initial Balance","category":"Range & Breakout"},{"key":"ib-levels","label":"IB Levels","category":"Range & Breakout"},{"key":"orb","label":"Opening Range Breakout","category":"Range & Breakout"},{"key":"previous-day-range","label":"Previous Day Range","category":"Range & Breakout"},{"key":"previous-week-range","label":"Previous Week Range","category":"Range & Breakout"},{"key":"opening-week-range","label":"Opening Week Range","category":"Range & Breakout"},{"key":"inside-bars","label":"Inside Bars","category":"Range & Breakout"},{"key":"range-expansion","label":"Range Expansion","category":"Range & Breakout"},{"key":"power-hour-breakout","label":"Power Hour Breakout","category":"Range & Breakout"},{"key":"opening-candle","label":"Opening Candle Continuation","category":"Continuation & Correlation"},{"key":"silver-bullet","label":"Silver Bullet","category":"Range & Breakout"},{"key":"session-breakout","label":"Market Session Breakout","category":"Range & Breakout"},{"key":"overnight-range","label":"Overnight Range","category":"Range & Breakout"},{"key":"overnight-mid","label":"Overnight Midpoint","category":"Range & Breakout"},{"key":"prev-session-correlation","label":"Previous Session Correlation","category":"Continuation & Correlation"},{"key":"streaks","label":"Green & Red Streaks","category":"Continuation & Correlation"},{"key":"power-hour-continuation","label":"Power Hour Continuation","category":"Continuation & Correlation"},{"key":"weekday-bias","label":"Green / Red by Weekday","category":"Timing & Volatility"},{"key":"seasonality","label":"Seasonality","category":"Timing & Volatility"},{"key":"daily-hl-by-session","label":"Daily High/Low by Session","category":"Timing & Volatility"},{"key":"volume","label":"Volume by Weekday","category":"Timing & Volatility"},{"key":"weekly-open-retracement","label":"Weekly Open Retracement","category":"Gap & Open"},{"key":"pivot-points","label":"Pivot Points","category":"Technical Levels"},{"key":"fibonacci","label":"Fibonacci Levels","category":"Technical Levels"},{"key":"value-area","label":"Value Area","category":"Technical Levels"},{"key":"engulfing","label":"Engulfing Candles","category":"Technical Levels"},{"key":"fvg","label":"Fair Value Gaps","category":"Technical Levels"},{"key":"adr","label":"Average Daily Range","category":"Timing & Volatility"}],"rateLimit":{"hourlyLimit":1000,"dailyLimit":10000,"note":"Current defaults; some accounts have a different per-account limit. Exceeding the hard limit locks the account until support clears it (see the fair use section of the Edge API help article)."},"endpoints":[{"path":"/meta","method":"GET","auth":true,"summary":"Lists available instruments (with data coverage), sessions, and reports. Call this first.","params":[],"example":"curl -H \"Authorization: Bearer edge_your_key_here\" \"https://console.tradestar.app/api/edge/v1/meta\""},{"path":"/sessions","method":"GET","auth":true,"summary":"Raw per-session records: open/high/low/close, range, gap, and initial-balance stats.","params":[{"name":"instrument","required":true,"type":"string","notes":"One of the instrument keys below."},{"name":"session","required":false,"type":"string","notes":"One of the instrument's sessions. Defaults to its defaultSession."},{"name":"from","required":false,"type":"date (YYYY-MM-DD)","notes":"Inclusive lower bound, interpreted in UTC."},{"name":"to","required":false,"type":"date (YYYY-MM-DD)","notes":"Inclusive upper bound, interpreted in UTC."}],"notes":["Returns at most 2,000 rows per call; response has truncated: true if more exist. Page with from/to."],"example":"curl -H \"Authorization: Bearer edge_your_key_here\" \"https://console.tradestar.app/api/edge/v1/sessions?instrument=NAS100&session=NY&from=2025-01-01&to=2025-06-30\""},{"path":"/edges","method":"GET","auth":true,"summary":"Discovered edges plus a summary (headline hit-rate, directional bias, by-weekday, levels) for one report.","params":[{"name":"instrument","required":true,"type":"string","notes":"One of the instrument keys below."},{"name":"report","required":true,"type":"string","notes":"One of the report keys below."},{"name":"session","required":false,"type":"string","notes":"One of the instrument's sessions. Defaults to its defaultSession."},{"name":"from","required":false,"type":"date (YYYY-MM-DD)","notes":"Restricts the computation to sessions on or after this date (a trailing window)."},{"name":"asOf","required":false,"type":"date (YYYY-MM-DD)","notes":"Restricts the computation to data up to this date, lookahead-free, for backtesting."},{"name":"window","required":false,"type":"integer (minutes)","notes":"Only accepted when report is one of: orb, orb-levels, opening-candle. Overrides that report's fixed window; 400 otherwise."}],"example":"curl -H \"Authorization: Bearer edge_your_key_here\" \"https://console.tradestar.app/api/edge/v1/edges?instrument=XAUUSD&report=gap-fill&session=FULL\""},{"path":"/today-bias","method":"GET","auth":true,"summary":"A single long/short/none signal for one report, for one weekday (today's ET weekday by default). The same lean the in-play box shows, packaged for automation. A historical weekday distribution, not a live-tape read, so it's safe to query pre-session.","params":[{"name":"instrument","required":true,"type":"string","notes":"One of the instrument keys below."},{"name":"report","required":true,"type":"string","notes":"One of the report keys below, except silver-bullet (unsupported here, use /edges instead)."},{"name":"session","required":false,"type":"string","notes":"Defaults to whichever session that report's own page uses (e.g. NY for IB/ORB), not the instrument's defaultSession."},{"name":"weekday","required":false,"type":"integer 0-6","notes":"0=Sun..6=Sat. Defaults to today's weekday in America/New_York."},{"name":"asOf","required":false,"type":"date (YYYY-MM-DD)","notes":"Restricts the computation to data up to this date."}],"notes":["Levels reports (ib-levels, orb-levels) have no directional lean and return { available: false, signal: \"none\" }.","report=silver-bullet returns 400. It runs on a different engine than this endpoint wraps."],"example":"curl -H \"Authorization: Bearer edge_your_key_here\" \"https://console.tradestar.app/api/edge/v1/today-bias?instrument=NAS100&report=orb&session=NY\""},{"path":"/in-play","method":"GET","auth":true,"summary":"Today's actual range formation, read live off the real-time feed (~60s cache) once the opening range has closed for the day, the same read the in-play box shows. Only for initial-balance, ib-levels, orb and orb-levels. Market-hours gated: returns available: false outside trading hours, at weekends, or while the range is still forming.","params":[{"name":"instrument","required":true,"type":"string","notes":"One of the instrument keys below."},{"name":"report","required":true,"type":"string","notes":"One of: initial-balance, ib-levels, orb, orb-levels. Any other value returns 400."},{"name":"session","required":false,"type":"string","notes":"Defaults to whichever session that report's own page uses (e.g. NY for IB/ORB)."}],"notes":["The response's source field is \"live\" when today's row came straight off the real-time feed, or \"ingest\" when it fell back to the last historical-ingest row (the live feed was unavailable). Either way this is the freshest read available, unlike the other endpoints, which are all ~90min-lagged batch history.","Cross-midnight sessions (e.g. gold's FULL) aren't supported and always return available: false."],"example":"curl -H \"Authorization: Bearer edge_your_key_here\" \"https://console.tradestar.app/api/edge/v1/in-play?instrument=NAS100&report=orb&session=NY\""}],"errors":[{"status":401,"body":{"error":"Unauthorized"},"when":"Authorization: Bearer header missing, invalid, or revoked key."},{"status":400,"body":{"error":"Unknown or missing 'instrument'"},"when":"instrument missing or not recognised."},{"status":400,"body":{"error":"Unknown or missing 'report'"},"when":"report missing or not recognised (on /edges, /today-bias)."},{"status":400,"body":{"error":"'window' is not configurable for report '...'"},"when":"window passed on /edges for a report other than orb/orb-levels/opening-candle."},{"status":400,"body":{"error":"report not supported by this endpoint"},"when":"report=silver-bullet on /today-bias, or any report other than initial-balance/ib-levels/orb/orb-levels on /in-play."},{"status":429,"body":{"error":"rate_limited","message":"..."},"when":"hourly or daily request limit exceeded. The account is now locked until support clears it."},{"status":429,"body":{"error":"locked","message":"..."},"when":"the account was already locked (a prior rate-limit breach, or an admin action)."}]}