# Christies — 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.

> Browse and search Christie's auction catalogs to discover artworks, explore lots across live and online auctions, and access detailed information about specific pieces and their departments. Quickly find auction results, compare items, and research private sales all in one place.

**Category:** Marketplaces | **Website:** [christies.com/](https://christies.com/) | **Docs:** [parse.bot/marketplace/67cb2c45-62bd-4eee-b9fb-a4634ff1caba/christies-com-api](https://parse.bot/marketplace/67cb2c45-62bd-4eee-b9fb-a4634ff1caba/christies-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/christies/`
**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 auction detail

Fetch detailed metadata for a specific auction page including title, description, sale ID, and image URL. Requires the full auction landing page URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the auction landing page (e.g., https://www.christies.com/en/auction/post-war-to-present-30686/) |

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

### Get auction lots

Paginate through all lots in an auction. Requires either a sale_id or a valid auction URL from which the sale_id can be extracted. Returns up to 100 lots per page with estimate and price realized data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (starts at 1) |
| `sale_id` | string | No | Numeric sale ID of the auction (from get_auction_detail or URL). Either sale_id or url must be provided. |
| `url` | string | No | Auction URL (used to extract sale_id if sale_id not provided) |

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

### Get auction results overview

Fetch auctions held in a specific month and year. Returns a list of auctions with metadata including title, date, location, sale total, and type. Covers both live and online-only sales that have closed in the given period.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | integer | No | Month (1-12) |
| `year` | integer | No | Year (e.g., 2025) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/christies/get-auction-results-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"month":"<integer>","year":"<integer>"}'
```

### Get departments

List all departments/categories at Christie's. Returns department names and URLs. Departments represent collecting areas such as Impressionist Art, Jewellery, Watches, etc.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/christies/get-departments \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get lot detail

Fetch full details for an individual lot/artwork including artist, medium, dimensions, estimates, price realized, provenance, exhibition history, literature references, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the lot detail page (e.g., https://www.christies.com/en/lot/lot-6569871) |

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

### Get private sales

List available private sale categories with their images and URLs. Private sales are works available for immediate purchase outside the auction process.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/christies/get-private-sales \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search lots

Search Christie's database for lots matching a keyword. Returns paginated results sorted by relevance. Can search sold (past) lots or upcoming (available) lots.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `is_past` | boolean | No | Whether to search sold lots (true) or upcoming/available lots (false) |
| `page` | integer | No | Page number (starts at 1) |
| `query` | string | Yes | Search keyword (e.g., Picasso, Monet, landscape) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/christies/search-lots \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"is_past":"<boolean>","page":"<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.