{
 "name": "Faro Data API",
 "version": "1.0.0",
 "by": "Faro Económico Meritocrático",
 "site": "https://faro-economicopages.com",
 "docs": "https://faro-economicopages.com/developers",
 "what": "Daily-updated U.S. market data: federal contract awards sized against the winner's market cap (contract shocks), Faro DNA scores for 340+ stocks, strong stocks on sale, and an IPO radar.",
 "auth": "Optional. Without a key: 25 calls/day and 5 rows per list. With a key: 'Authorization: Bearer <key>' (or X-API-Key header, or ?key=). 1 credit per call.",
 "pricing": {
  "plans": [
   {
    "plan": "starter",
    "price_usd": 5,
    "credits": 1000,
    "checkout_url": "https://faro-economicopages.com/api/v1/checkout?plan=starter"
   },
   {
    "plan": "pro",
    "price_usd": 20,
    "credits": 5000,
    "checkout_url": "https://faro-economicopages.com/api/v1/checkout?plan=pro"
   },
   {
    "plan": "fondo",
    "price_usd": 50,
    "credits": 15000,
    "checkout_url": "https://faro-economicopages.com/api/v1/checkout?plan=fondo"
   }
  ],
  "how": "Open a checkout_url in a browser and pay by card (Stripe). You land on https://faro-economicopages.com/developers with your API key. Send it as 'Authorization: Bearer <key>' (or ?key=<key>). 1 credit = 1 call. Credits last 12 months. No subscription.",
  "docs": "https://faro-economicopages.com/developers"
 },
 "mcp": {
  "url": "https://faro-economicopages.com/mcp",
  "transport": "streamable-http (JSON responses, stateless)",
  "auth": "same key as Bearer token, or https://faro-economicopages.com/mcp?key=<key>"
 },
 "alerts": {
  "name": "Contract Shock Alerts",
  "price_usd_month": 29,
  "what": "Webhook (Discord, Slack or JSON) every time a new federal award is worth ≥ your threshold (default 2%) of the winning company's market cap.",
  "subscribe_url": "https://faro-economicopages.com/api/v1/alerts/checkout",
  "docs": "https://faro-economicopages.com/developers#alerts"
 },
 "openapi": "https://faro-economicopages.com/api/v1/openapi.json",
 "endpoints": [
  {
   "route": "GET /api/v1/contracts",
   "tool": "federal_contracts",
   "does": "Recent U.S. federal contract awards (Department of War daily announcements + USAspending) won by publicly traded companies, newest first. Each award includes its size as a % of the winner's market cap and the stock move since the announcement.",
   "params": [
    "days",
    "agency",
    "min_amount",
    "limit"
   ]
  },
  {
   "route": "GET /api/v1/contracts/shocks",
   "tool": "contract_shocks",
   "does": "Federal awards that are large relative to the winning company's size: award value ÷ market cap ≥ min_pct. A $500M award means little to a $200B prime but a lot to a $5B company.",
   "params": [
    "min_pct",
    "days",
    "exclude_ceilings",
    "limit"
   ]
  },
  {
   "route": "GET /api/v1/contracts/recipients",
   "tool": "contract_recipients",
   "does": "Public companies ranked by total federal awards in the window relative to their market cap, with award count, largest award and stock move since the first award.",
   "params": [
    "sort",
    "limit"
   ]
  },
  {
   "route": "GET /api/v1/dna/{ticker}",
   "tool": "stock_dna",
   "does": "The Faro DNA score (0–100) of a U.S. stock and its 7 pillars: track record, revenue, quality, cash, price, balance sheet and federal-money flow. Levels: fuerte (strong), prometedor (promising), mixto (mixed), debil (weak).",
   "params": []
  },
  {
   "route": "GET /api/v1/dna",
   "tool": "rank_dna",
   "does": "Ranking of 340+ U.S. stocks by Faro DNA score, filterable by minimum score, level and sector.",
   "params": [
    "min_score",
    "level",
    "sector",
    "limit"
   ]
  },
  {
   "route": "GET /api/v1/dips",
   "tool": "quality_dips",
   "does": "Stocks with 15+ years of strong history (≥7%/yr, ≥60% positive years) now 3–25% below their all-time high. Includes 1/3/5/7/10-year total returns, 10- and 20-year CAGR, volatility, dividend yield and DNA score.",
   "params": [
    "sector",
    "max_drawdown_pct",
    "lang",
    "limit"
   ]
  },
  {
   "route": "GET /api/v1/ipos",
   "tool": "ipo_radar",
   "does": "U.S. IPOs of the last 13 months with return since IPO, DNA score, revenue growth and lock-up date; plus upcoming IPOs.",
   "params": [
    "below_ipo",
    "sort",
    "limit"
   ]
  },
  {
   "route": "GET /api/v1/stock/{ticker}",
   "tool": "stock_profile",
   "does": "One call: DNA score and pillars, federal contracts of the last 60 days, contract-size stats, price vs 52-week high, long-term returns and IPO data when applicable.",
   "params": [
    "lang"
   ]
  },
  {
   "route": "GET /api/v1/account",
   "tool": "account",
   "does": "Credits left on your API key (or free calls left today without a key) and how to buy more. Free; does not use a credit.",
   "params": []
  }
 ],
 "disclaimer": "Educational data compiled from public sources. Not investment advice."
}