# Chrono24 — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Chrono24 provides 2 callable API endpoints through the Parse marketplace.

**Category:** Marketplaces | **Website:** [www.chrono24.com/](https://www.chrono24.com/) | **Docs:** [parse.bot/marketplace/51f0e2b4-7bdf-4759-b36a-9d0197b8f8ec/chrono24-com-api](https://parse.bot/marketplace/51f0e2b4-7bdf-4759-b36a-9d0197b8f8ec/chrono24-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/chrono24/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get watch details

Retrieve full details for a single watch listing including all photos, specifications (case size, movement, materials), caliber information, condition, production year, and seller details. Accepts either a numeric listing_id or a full listing URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | No | Numeric listing ID from search_watches results (e.g. from listing_id field). |
| `url` | string | No | Full listing URL from search_watches results (e.g. from listing_url field). Either listing_id or url must be provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/chrono24/get-watch-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>","url":"<string>"}'
```

### Search watches

Full-text search across Chrono24 watch listings. Returns up to 60 results per query with basic listing data including price, brand, model, and seller country. Results are ordered by relevance. Each result carries a listing_id usable with get_watch_details for full specs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (capped at 60). |
| `query` | string | Yes | Search query for watches (brand, model, reference number, or keywords). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/chrono24/search-watches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.