# nfin API Reference

This is the API reference for nfin, the free hosted Nasdaq API for builders and AI agents.

Canonical docs:
- https://docs.nfin.dev

Machine-readable contracts:
- OpenAPI JSON: https://api.nfin.dev/v1/openapi.json
- Endpoint catalog: https://api.nfin.dev/v1/endpoints

Base API URL:
- https://api.nfin.dev

Rate limits:
- Anonymous: 20 rps / 1,200 rpm
- API key: 500 rps / 30,000 rpm

Authentication:
- Anonymous requests work without setup.
- API keys are issued after email verification through /v1/auth/otp and /v1/auth/verify.
- Send API keys as Authorization: Bearer <key>.

Recommended route discovery for agents:
1. Fetch https://api.nfin.dev/v1/openapi.json.
2. Use operation IDs, parameter schemas, and response schemas from that OpenAPI document.
3. Use https://api.nfin.dev/v1/endpoints for a compact endpoint catalog.

Common routes:
- GET /v1/search
- GET /v1/quotes/basic
- GET /v1/quotes/indices
- GET /v1/quotes/watchlist
- GET /v1/quote/{symbol}/summary
- GET /v1/quote/{symbol}/info
- GET /v1/quote/{symbol}/historical
- GET /v1/quote/{symbol}/chart
- GET /v1/quote/{symbol}/options
- GET /v1/quote/{symbol}/options/greeks
- GET /v1/calendar/earnings
- GET /v1/calendar/dividends
- GET /v1/calendar/splits
- GET /v1/ipo/calendar
- GET /v1/markets/movers
- GET /v1/screener/{type}
- GET /v1/company/ownership
- GET /v1/nordic/search