{"name": "Sharemaestro Market Research API", "purpose": "Structured weekly market research data for people, applications, and AI systems.", "schema": "https://sharemaestro.com/api/schema/", "docs": "https://sharemaestro.com/api/docs/", "rate_limit": {"requests": 240, "window_seconds": 60, "scope": "per client across public API endpoints", "headers": ["X-RateLimit-Limit", "X-RateLimit-Window", "X-RateLimit-Remaining", "Retry-After"]}, "endpoint_groups": [{"group": "Discovery", "summary": "Entry points, schema, search, and machine-readable API metadata.", "endpoints": [{"label": "API index", "method": "GET", "url": "https://sharemaestro.com/api/", "cadence": "Live", "description": "Public API overview, terms, endpoint families, and usage boundaries."}, {"label": "API docs", "method": "GET", "url": "https://sharemaestro.com/api/docs/", "cadence": "Live", "description": "Human-readable API guide."}, {"label": "OpenAPI schema", "method": "GET", "url": "https://sharemaestro.com/api/schema/", "cadence": "Live", "description": "Machine-readable schema for the central API."}, {"label": "Search", "method": "GET", "url": "https://sharemaestro.com/api/search/?q=AAPL", "cadence": "Live", "description": "Search active traditional tickers and crypto assets."}]}, {"group": "Ticker Research", "summary": "Weekly chart data and top-level research outputs for active instruments.", "endpoints": [{"label": "Ticker detail", "method": "GET", "url": "https://sharemaestro.com/api/tickers/%7Buuid%7D/", "cadence": "Weekly", "description": "Ticker metadata, OHLCV, public signals, chart summary, and key points."}, {"label": "Equity report", "method": "GET", "url": "https://sharemaestro.com/terminal/%7Buuid%7D/report/api/", "cadence": "Weekly", "description": "Equity-only weekly report payload covering price, volume, signals, peers, sector/industry context, risk, and watch points."}, {"label": "Market news archive", "method": "GET", "url": "https://sharemaestro.com/news/", "cadence": "Hourly", "description": "Published Sharemaestro market research articles for US equities."}, {"label": "Market news RSS", "method": "GET", "url": "https://sharemaestro.com/news/feed/", "cadence": "Hourly", "description": "RSS feed for published market news articles."}, {"label": "Market news API", "method": "GET", "url": "https://sharemaestro.com/api/news/", "cadence": "Hourly", "description": "Published Sharemaestro market research article summaries, source URLs, ticker context, and feed links."}, {"label": "Market news article API", "method": "GET", "url": "https://sharemaestro.com/api/news/%7Bslug%7D/", "cadence": "Hourly", "description": "Single published article payload with body sections, key points, source links, ticker context, signals, and supporting research links."}, {"label": "Market Watch API", "method": "GET", "url": "https://sharemaestro.com/api/market-watch/", "cadence": "15 minutes", "description": "Live Sharemaestro market-watch posts with concise editorial context, equities, crypto, intraday data, and chart or image visuals."}, {"label": "Market Watch post API", "method": "GET", "url": "https://sharemaestro.com/api/market-watch/%7Bslug%7D/", "cadence": "15 minutes", "description": "Single Market Watch post with evidence context, supporting visual, ticker links, and source metadata."}, {"label": "Finance profiles API", "method": "GET", "url": "https://sharemaestro.com/api/blog/", "cadence": "Daily", "description": "Long-form sourced finance profiles on investors, traders, fund managers, and market pioneers."}, {"label": "Finance profile article API", "method": "GET", "url": "https://sharemaestro.com/api/blog/%7Bslug%7D/", "cadence": "Daily", "description": "Single finance profile payload with body sections, citations, source pack, performance markers, and chart data."}]}, {"group": "Market Structure", "summary": "Country, sector, industry, and global market structure built from supported equities.", "endpoints": [{"label": "Country structure", "method": "GET", "url": "https://sharemaestro.com/api/structure/", "cadence": "Weekly", "description": "Country index summaries and links."}, {"label": "Country detail", "method": "GET", "url": "https://sharemaestro.com/api/structure/%7Bcountry_code%7D/", "cadence": "Weekly", "description": "Country index, leading sectors, leading industries, and chart data."}, {"label": "Sector detail", "method": "GET", "url": "https://sharemaestro.com/api/structure/%7Bcountry_code%7D/%7Bsector_slug%7D/", "cadence": "Weekly", "description": "Sector index, industry drilldowns, constituents, and chart data."}, {"label": "Industry detail", "method": "GET", "url": "https://sharemaestro.com/api/structure/%7Bcountry_code%7D/%7Bsector_slug%7D/%7Bindustry_slug%7D/", "cadence": "Weekly", "description": "Industry index, constituents, and chart data."}, {"label": "Global structure", "method": "GET", "url": "https://sharemaestro.com/api/global/", "cadence": "Weekly", "description": "SM Global Market Index, global sectors, global industries, and breadth."}, {"label": "Global search", "method": "GET", "url": "https://sharemaestro.com/api/global/search/?q=technology", "cadence": "Weekly", "description": "Search global sector and industry indexes."}]}, {"group": "Market Apps", "summary": "High-level market dashboards across crypto, commodities, indexes, radar, and prediction markets.", "endpoints": [{"label": "Crypto API", "method": "GET", "url": "https://sharemaestro.com/crypto/api/", "cadence": "Intraday/Daily", "description": "Crypto endpoint discovery, market index, assets, and search."}, {"label": "Commodities API", "method": "GET", "url": "https://sharemaestro.com/commodities/api/", "cadence": "Intraday/Daily", "description": "Commodity market overview, groups, assets, and search."}, {"label": "Indexes API", "method": "GET", "url": "https://sharemaestro.com/indexes/api/", "cadence": "Intraday/Daily", "description": "Major index market data and SM Global Index payloads."}, {"label": "Active movers", "method": "GET", "url": "https://sharemaestro.com/api/active-movers/", "cadence": "5 minutes during US market hours; weekly fallback when closed", "description": "Top gainers, top losers, and most active tracked US stocks and ETFs, ranked from Sharemaestro's own universe and matched to chart, report, and factor context."}, {"label": "Insider activity", "method": "GET", "url": "https://sharemaestro.com/api/insider-activity/", "cadence": "Weekdays 11:45 and 22:45 UK", "description": "Recent insider transaction filings across tracked US equities, grouped into company-level acquisition and disposal context."}, {"label": "Earnings calendar", "method": "GET", "url": "https://sharemaestro.com/api/earnings-calendar/", "cadence": "Daily", "description": "Upcoming US earnings events with report date, fiscal period, estimate, sector, and ticker links."}, {"label": "Options Intelligence", "method": "GET", "url": "https://sharemaestro.com/api/options-radar/", "cadence": "10 minutes during US market hours", "description": "Derived options intelligence covering options pressure, put-call balance, expected move, volume-to-open-interest participation, volatility, and trend-confirmation context."}, {"label": "Prediction markets", "method": "GET", "url": "https://sharemaestro.com/predictions/api/", "cadence": "Hourly", "description": "Prediction market dashboard, themes, and active market snapshots."}, {"label": "Market radar", "method": "GET", "url": "https://sharemaestro.com/market-radar/api/", "cadence": "Hourly", "description": "Global and country market radar sections."}, {"label": "Trending stocks", "method": "GET", "url": "https://sharemaestro.com/trending/api/", "cadence": "Weekly", "description": "Country-selected stocks and ETFs with exactly 4 to 8 positive smoothed trend signals after flipping from 0 to 1."}, {"label": "Advance / Decline API", "method": "GET", "url": "https://sharemaestro.com/advance-decline/api/", "cadence": "Weekly", "description": "Exchange-level market internals covering advance/decline breadth, trend participation, fair-value breadth, reversal pressure, sector breadth, and public chart series."}, {"label": "Advance / Decline exchanges", "method": "GET", "url": "https://sharemaestro.com/advance-decline/api/exchanges/", "cadence": "Weekly", "description": "Supported exchange coverage and latest public advance/decline readings."}, {"label": "Advance / Decline exchange detail", "method": "GET", "url": "https://sharemaestro.com/advance-decline/api/exchanges/%7Bsymbol%7D/", "cadence": "Weekly", "description": "Latest public exchange snapshot, chart data, sector breakdowns, divergence alerts, and valuation context without proprietary calculation internals."}]}, {"group": "ETF Radar", "summary": "ETF market, country, category, list, and detail endpoints.", "endpoints": [{"label": "ETF dashboard", "method": "GET", "url": "https://sharemaestro.com/etfs/api/", "cadence": "Weekly", "description": "ETF breadth, rotation, opportunities, risk, volume, and categories."}, {"label": "ETF country", "method": "GET", "url": "https://sharemaestro.com/etfs/%7Bcountry%7D/api/", "cadence": "Weekly", "description": "Country ETF radar and local lists."}, {"label": "ETF list", "method": "GET", "url": "https://sharemaestro.com/etfs/lists/%7Blist_key%7D/api/", "cadence": "Weekly", "description": "Ranked ETF lists such as opportunities, volume surges, breakouts, and risk watch."}, {"label": "ETF category", "method": "GET", "url": "https://sharemaestro.com/etfs/categories/%7Bcategory_slug%7D/api/", "cadence": "Weekly", "description": "Category constituents ranked by ETF radar score."}, {"label": "ETF detail", "method": "GET", "url": "https://sharemaestro.com/etfs/%7Bcountry%7D/%7Bexchange%7D/%7Bsymbol%7D/api/", "cadence": "Weekly", "description": "ETF summary, category peers, signals, risk, opportunity, and chart links."}]}, {"group": "Equity Research Apps", "summary": "Factor, quality, dividend, smart-money, and patient-capital research outputs.", "endpoints": [{"label": "Factors API", "method": "GET", "url": "https://sharemaestro.com/factors/api/", "cadence": "Weekly", "description": "Factor endpoint discovery, schema, universes, factors, presets, strategies, sectors, and ticker payloads."}, {"label": "SVQF API", "method": "GET", "url": "https://sharemaestro.com/svqf/api/", "cadence": "Weekly", "description": "Shareholder-value quality framework metadata, exchanges, screeners, sectors, runs, and ticker payloads."}, {"label": "Smart Money API", "method": "GET", "url": "https://sharemaestro.com/smart-money/api/", "cadence": "Weekly", "description": "Member-protected Smart Money dashboard and ticker signal payloads."}, {"label": "Dividend Compounders API", "method": "GET", "url": "https://sharemaestro.com/dividend-compounders/api/", "cadence": "Weekly", "description": "Dividend reliability, sustainability, quality, valuation, and trend research."}, {"label": "Patient Capital API", "method": "GET", "url": "https://sharemaestro.com/patient-capital/api/", "cadence": "Weekly", "description": "Long-horizon equity candidates with patient-capital style ranking and screen context."}]}, {"group": "Signals and Screeners", "summary": "Public screeners and event filters for discovery workflows.", "endpoints": [{"label": "Signal filters", "method": "GET", "url": "https://sharemaestro.com/filters/api/", "cadence": "Weekly", "description": "Event-week filters for trend, dynamics, fair value, SMI, ROC, and confluence views."}, {"label": "CSI sectors", "method": "GET", "url": "https://sharemaestro.com/csiscreener/api/sectors/", "cadence": "Weekly", "description": "CSI screener sector options and related metadata."}, {"label": "CSI industries", "method": "GET", "url": "https://sharemaestro.com/csiscreener/api/industries/", "cadence": "Weekly", "description": "CSI screener industry options and related metadata."}]}], "boundaries": ["Public payloads expose research outputs and plain-language terms, not private formulas or calculation internals.", "Use the values as educational market research, not investment, legal, tax, or trading advice.", "Market data may be delayed, adjusted, incomplete, or revised after vendor updates.", "Please cache responsibly and identify heavy integrations before scaling traffic."], "terms": {"weekly_close": "The adjusted weekly close price.", "trend_line": "The primary long-term trend reference displayed on Sharemaestro charts.", "trend_signal": "A binary trend condition shown as 0 or 1.", "relative_strength": "Relative performance versus the exchange benchmark.", "activity_lines": "Shorter-horizon activity references displayed on Sharemaestro charts.", "rate_of_change": "Trend Line rate of change.", "fair_value": "Rolling fair value reference.", "expectation": "Directional probability reading derived from current market and indicator state.", "market_dynamics": "A proprietary market behaviour indicator."}, "endpoints": {"ticker_detail": "https://sharemaestro.com/api/tickers/{uuid}/", "market_news": "https://sharemaestro.com/api/news/", "market_news_article": "https://sharemaestro.com/api/news/{slug}/", "market_watch": "https://sharemaestro.com/api/market-watch/", "market_watch_post": "https://sharemaestro.com/api/market-watch/{slug}/", "finance_profiles": "https://sharemaestro.com/api/blog/", "finance_profile": "https://sharemaestro.com/api/blog/{slug}/", "active_movers": "https://sharemaestro.com/api/active-movers/", "insider_activity": "https://sharemaestro.com/api/insider-activity/", "earnings_calendar": "https://sharemaestro.com/api/earnings-calendar/", "options_radar": "https://sharemaestro.com/api/options-radar/", "search": "https://sharemaestro.com/api/search/?q={symbol_or_name}", "crypto_search": "https://sharemaestro.com/crypto/api/search/?q={symbol_or_name}", "structure": "https://sharemaestro.com/api/structure/", "structure_country": "https://sharemaestro.com/api/structure/{country_code}/", "structure_sector": "https://sharemaestro.com/api/structure/{country_code}/{sector_slug}/", "structure_industry": "https://sharemaestro.com/api/structure/{country_code}/{sector_slug}/{industry_slug}/", "global_structure": "https://sharemaestro.com/api/global/", "global_structure_sector": "https://sharemaestro.com/api/global/sectors/{sector_slug}/", "global_structure_industry": "https://sharemaestro.com/api/global/sectors/{sector_slug}/{industry_slug}/", "global_structure_search": "https://sharemaestro.com/api/global/search/?q={sector_or_industry}", "trending_stocks": "https://sharemaestro.com/trending/api/?country={country_code}&page={page}", "advance_decline": "https://sharemaestro.com/advance-decline/api/", "advance_decline_exchanges": "https://sharemaestro.com/advance-decline/api/exchanges/", "advance_decline_exchange": "https://sharemaestro.com/advance-decline/api/exchanges/{symbol}/", "schema": "https://sharemaestro.com/api/schema/"}, "market_structure_methodology": {"grouping": "country -> sector -> industry", "price_basis": "adjusted weekly close", "public_terms": ["Index Value", "Trend Line", "Trend Signal", "Activity Lines", "Fair Value", "Breadth"], "automation": "Structure indexes are rebuilt by Celery Beat on a weekly schedule and after eligible ticker deletions."}, "global_structure_methodology": {"grouping": "global -> sector -> industry", "price_basis": "adjusted weekly close", "public_terms": ["SM Global Market Index", "Index Value", "Trend Line", "Trend Signal", "Activity Lines", "Fair Value", "Breadth"], "automation": "Global indexes are rebuilt by Celery Beat early Monday morning with batch storage."}, "disclaimer": "Educational and research use only. Not financial, investment, trading, tax, or legal advice."}