# tvfin

> tvfin is a free, hosted TradingView API for builders and their agents. The
> API self-describes: the OpenAPI contract and a machine-readable endpoint
> catalog are served live by the API itself, so they never go stale.

## API contract

- [OpenAPI JSON](https://api.tvfin.bluedoor.sh/v1/openapi.json) - Full OpenAPI 3.1 contract, generated live by the API.
- [Endpoint catalog](https://api.tvfin.bluedoor.sh/v1/endpoints) - Machine-readable list of endpoints for tool discovery and codegen.
- [API reference](https://docs.tvfin.bluedoor.sh/) - Interactive reference, rendered live from the OpenAPI contract.
- [Health](https://api.tvfin.bluedoor.sh/v1/health) - Service status and number of shipped endpoints.

## Project

- [GitHub](https://github.com/bluefin-ai/fin-services/tree/main/tvfin/tvfin) - Source, SDKs (Python and TypeScript), and issues.
- [tvfin.bluedoor.sh](https://tvfin.bluedoor.sh) - Landing page.