# brapi.dev API agent index

- [OpenAPI contract](https://brapi.dev/openapi.json)
- [API catalog](https://brapi.dev/.well-known/api-catalog)
- [Authentication](https://brapi.dev/auth.md)
- [Versioning policy](https://brapi.dev/docs/versioning)
- [Rate limits](https://brapi.dev/auth.md#errors)

Use versioned query-based endpoints under `/api/v2`.
Use `symbols` for ticker lists.
Read `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset`.
Wait for `Retry-After` after HTTP 429.
For versioning, prefer `/api/v2`. Read `Deprecation`, `Sunset`, and the deprecation `Link` header before migrating a legacy route.