---
title: "Watch a market (captures a baseline now). Free and unlimited on every tier."
method: POST
path: "/v1/tracked"
---

# Watch a market (captures a baseline now). Free and unlimited on every tier.

`POST /v1/tracked`

## Request

- Base URL: `https://api.americantradesindex.com`
- URL: `https://api.americantradesindex.com/v1/tracked`
- Auth: HTTP bearer

## Request body

- object
  - `label` string, required
  - `kind` 'projects' | 'project' | 'company' | 'supply' | 'movement' | 'rankings' | 'county' | 'outlook' | 'screen', required
  - `params` object: projects: {state and/or fips|county|cbsa, watch:"projects"} (a territory's projects and the week's new stage events); project: {project_id, name}; company: {company_key, name}; supply/movement: {state, trade, county?|metro?}; county/outlook: {fips|state+county, trade}; rankings: {trade, metric}; screen: the screen filters
  - `folder_id` string

## Response `200`

tracked item

## Other responses

- `400`: invalid_request: detail names the field
- `401`: unauthorized: missing, invalid or revoked key
- `402`: upgrade_required (no active plan), credits_exhausted (period pool used up) or payment_required (last charge failed); body carries an `upgrade` URL
- `429`: rate_limited (120/min per workspace). Every response carries RateLimit-Limit/Remaining/Reset/Policy; a 429 adds Retry-After

---

[API](https://skmtc.dev/americantradesindex/apis/american-trades-index-api.md) · [All operations](https://skmtc.dev/americantradesindex/apis/american-trades-index-api/llms.txt) · [OpenAPI document](https://skmtc.dev/americantradesindex/apis/american-trades-index-api/revisions/5a9de4d8c76b?raw)