{"authentication":{"example":"X-API-Key: sd_live_xxx","header":"X-API-Key","method":"API Key"},"common_tasks":{"avoid_lookahead_bias":"Add ?as_of=YYYY-MM-DD to get point-in-time data","bulk_query":"POST /api/v1/query with universe, fields, and range","compare_companies":"GET /api/v1/compare?tickers=AAPL,MSFT,GOOGL&metrics=revenue,net_income","get_etf_holdings":"GET /api/v1/holdings/{etf_ticker}","get_financials":"GET /api/v1/fundamentals/{ticker}?periods=4","get_stock_price":"GET /api/v1/prices/{ticker}?start=YYYY-MM-DD&end=YYYY-MM-DD"},"error_handling":{"401":"Invalid or missing API key","403":"Subscription tier does not include this feature","404":"Entity not found - check ticker or use /resolve","429":"Rate limit exceeded - wait or upgrade tier"},"key_concepts":{"adjustment_models":{"raw":"Unadjusted prices as traded","split_adjusted":"Adjusted for stock splits (default)","total_return":"Adjusted for splits and dividends"},"point_in_time":"Query data as it was known at a specific date to prevent lookahead bias","synapse_id":"Permanent identifier that never changes, even across ticker changes or mergers"},"purpose":"Synapse Discovery is a financial data API providing stock prices, fundamentals, ETF holdings, and macro data with AI-native design.","quick_start":["1. Get your API key from https://synapsediscovery.io/portal/api-keys","2. Discover capabilities: GET /api/v1/meta","3. Understand field types: GET /api/v1/schema","4. Resolve a company: GET /api/v1/resolve?q=Apple","5. Get prices: GET /api/v1/prices/AAPL?start=2024-01-01"],"response_structure":{"cost":"API units consumed and cache status","data":"The actual response payload","meta":"Additional context (counts, identifiers, etc.)","provenance":"Source and collection metadata for audit","quality":"Data completeness and freshness metrics"},"tips":["Use /resolve for fuzzy matching when unsure of exact ticker","Always specify adjustment_model for prices to avoid ambiguity","Use point_in_time=true for backtesting to prevent lookahead bias","The /query endpoint is more efficient for multi-entity requests"]}