{"openapi":"3.1.0","info":{"title":"FxRobotEasy Public API","version":"1.0.0","description":"Read-only API for retrieving forex robot research data, live trading metrics, glossary entries, and structured SEO content from FxRobotEasy.com. All endpoints are unauthenticated and rate-limited at the edge. AI agents are explicitly welcomed (see /llms.txt).","contact":{"name":"FxRobotEasy Editorial Team","url":"https://www.fxroboteasy.com/about"},"license":{"name":"Public, attribution required","url":"https://www.fxroboteasy.com/about/disclosure"}},"servers":[{"url":"https://www.fxroboteasy.com","description":"Production"}],"tags":[{"name":"experts","description":"Expert Advisor reviews and ratings"},{"name":"best","description":"Curated best-of hub data"},{"name":"guide","description":"Long-form educational guides"},{"name":"glossary","description":"Forex term definitions"},{"name":"compare","description":"Head-to-head comparison data"},{"name":"symbol","description":"Trading robots by instrument"},{"name":"live","description":"Live trading metrics"},{"name":"ai","description":"AI / LLM helpers (Markdown, JSON-LD)"}],"paths":{"/api/live-trades":{"get":{"tags":["live"],"summary":"Live trade ticker","description":"Returns the latest verified live trades across all monitored accounts. Refreshed every ~60 seconds.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LiveTrade"}}}}}}}}}},"/api/products/{id}/stats":{"get":{"tags":["live"],"summary":"Performance statistics for a product/account","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/products/{id}/performance-curve":{"get":{"tags":["live"],"summary":"Performance curve data points","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/products/{id}/top-brokers":{"get":{"tags":["live"],"summary":"Top brokers used for this product","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/md/{type}/{slug}":{"get":{"tags":["ai"],"summary":"Markdown rendering of any SEO hub page","description":"Returns a clean Markdown rendering of a Best / Guide / Compare / Symbol / Glossary page. Optimised for AI agents and 'reader mode' clients. Same content also served as `/{type}/{slug}.md`.","parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["best","guide","compare","symbol","glossary","trading-robots-for"]}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Not found"}}}},"/api/jsonld/feed":{"get":{"tags":["ai"],"summary":"Aggregate JSON-LD feed","description":"Returns a streaming JSON-LD graph of every public SEO page. Includes BreadcrumbList, CollectionPage, Article, FAQPage, ItemList, and Speakable entries. Used by AI ingest pipelines and structured-data crawlers.","responses":{"200":{"description":"OK"}}}},"/llms.txt":{"get":{"tags":["ai"],"summary":"Plain-prose summary for LLMs","responses":{"200":{"description":"OK"}}}},"/llms-full.txt":{"get":{"tags":["ai"],"summary":"Enumerated index of every public SEO hub URL","responses":{"200":{"description":"OK"}}}},"/api/v1/glossary":{"get":{"tags":["glossary"],"summary":"List glossary terms","description":"Returns the full forex trading glossary in JSON form (term, slug, definition, related terms).","responses":{"200":{"description":"OK"}}}},"/api/v1/best":{"get":{"tags":["best"],"summary":"List active best-of hubs","description":"Returns metadata for every published `seo_hub_pages` row of `page_type='best'`.","responses":{"200":{"description":"OK"}}}},"/api/v1/research":{"get":{"tags":["live"],"summary":"Research datasets index","description":"Returns a list of available research datasets (Sharpe ratio, drawdown studies, etc.).","responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"LiveTrade":{"type":"object","properties":{"id":{"type":"string"},"account_id":{"type":"string"},"symbol":{"type":"string"},"direction":{"type":"string","enum":["buy","sell"]},"open_price":{"type":"number"},"close_price":{"type":"number"},"opened_at":{"type":"string","format":"date-time"},"closed_at":{"type":"string","format":"date-time"},"pnl_value":{"type":"number"},"lots":{"type":"number"}}}}}}