# mkts — Market Data API

> Free real-time market data for stocks, crypto, ETFs, and commodities. No API key required.

## API
- Base URL: https://mkts.io/api/v1
- OpenAPI spec: https://mkts.io/api/v1/openapi.json
- Auth: None required (20 req/hour). Register at POST /api/v1/register for higher limits.

## Endpoints
- GET /market — Global market overview
- GET /assets — Filtered, paginated asset list
- GET /asset/{symbol} — Single asset detail
- GET /asset/{symbol}/live — Real-time quote
- GET /asset/{symbol}/details — Stock/ETF fundamentals (financials, earnings, analysts, ownership, filings)
- GET /asset/{symbol}/filings — Direct SEC filing feed for stocks/ETFs
- GET /filings/search — Cross-company SEC filing search across stocks/ETFs
- GET /asset/{symbol}/options — Options chain (calls, puts, OI, IV, expirations)
- GET /asset/{symbol}/fundamentals — Historical financial statements (income, balance sheet, cash flow)
- GET /fundamentals/screen — Fundamentals screener over valuation, growth, margins, leverage, and cash flow
- GET /trending — Most active, top gainers, top losers (Yahoo screener, pre-cached)
- GET /movers — Top gainers & losers
- GET /screen — Screener with filters
- GET /sectors — Sector performance
- GET /compare — Side-by-side compare
- GET /brief — Curated market brief (best for agents)
- GET /asset/{symbol}/history — Daily OHLCV historical prices
- GET /earnings — Earnings calendar with EPS estimates
- GET /portfolio/card — Shareable portfolio card image
- GET /news — Financial news feed
- POST /register — Get a free API key
- GET /ping — Health check & data freshness

## Agent Integration
- OpenClaw skill: https://mkts.io/SKILL.md
- AI plugin manifest: https://mkts.io/.well-known/ai-plugin.json
- Agent manifest: https://mkts.io/.well-known/agent.json