# EVE Contracts

> A public tracker for EVE Online contracts. Every EVE region is polled from CCP ESI, and the resulting contracts, item listings, and price history are browsable on the site and available through a free, unauthenticated read-only JSON API.

The JSON API is the right way to read data programmatically — do not scrape the HTML pages, which are server-rendered from the same tables. No API key or sign-in is needed for any of it. Rate limit: 120 requests per 60 seconds per IP.

Scope note: only *public* contracts are exposed. Contracts belonging to a signed-in user's character or corporation are private and never appear in the API.

## API

- [API reference](https://contracts.tovdc.com/docs/api): Human-readable documentation for every endpoint, with examples.
- [Full API details for LLMs](https://contracts.tovdc.com/llms-full.txt): Every endpoint and parameter inlined in one file.
- [OpenAPI 3.1 spec](https://contracts.tovdc.com/api/v1/openapi.json): Machine-readable spec, suitable for client generation.
- [Service index](https://contracts.tovdc.com/api/v1): Endpoint list, rate limit, and dataset links.

## Endpoints

- [Search public contracts](https://contracts.tovdc.com/api/v1/contracts): Paginated search over every public contract we have ingested, across all EVE regions.
- [Get one contract with its items](https://contracts.tovdc.com/api/v1/contracts/{contract_id}): Full contract record including the item list with blueprint metadata (runs, ME, TE, BPC/BPO) and resolved location names.
- [List EVE regions](https://contracts.tovdc.com/api/v1/regions): Every region id and name.
- [Look up item types](https://contracts.tovdc.com/api/v1/types): Resolve an item name to a `type_id` (or a `type_id` back to a name).
- [List item category filter codes](https://contracts.tovdc.com/api/v1/categories): Accepted values for the `category` parameter on /api/v1/contracts.
- [Dataset size and freshness](https://contracts.tovdc.com/api/v1/stats): Total and outstanding contract counts, contracts seen in the last 24h, and the timestamp of the most recent ingest.
- [Hourly price history for an item in a region](https://contracts.tovdc.com/api/v1/analytics/prices): Min/median/max unit price per hour, derived from outstanding single-item item_exchange contracts.
- [Contracts posted per day, per region](https://contracts.tovdc.com/api/v1/analytics/volume): Long-form daily counts of newly seen public contracts for the busiest regions.
- [Busiest contract issuers](https://contracts.tovdc.com/api/v1/analytics/issuers): Leaderboard of public-contract issuers over a rolling window.
- [Live contract depth for an item type](https://contracts.tovdc.com/api/v1/analytics/depth): Currently outstanding single-item item_exchange contracts for one type, cheapest unit price first.

## Site pages

- [Contract browser](https://contracts.tovdc.com/contracts): Filterable table of all public contracts.
- [Analytics](https://contracts.tovdc.com/analytics): Price history, contract volume, issuer leaderboard, and live market depth.

## Optional

- [Dataset stats](https://contracts.tovdc.com/api/v1/stats): Row counts and ingest freshness — check before relying on a query.
- [CCP ESI](https://esi.evetech.net/ui/): The upstream source of all contract data.