# Littleton Coin Company — 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.

> Search and browse coins, currency, and collectibles from Littleton Coin Company's catalog to find products by category or keyword. Retrieve detailed product information to compare specs, prices, and availability across their collection.

**Category:** E-commerce | **Website:** [www.littletoncoin.com/shop/coins-currency](https://www.littletoncoin.com/shop/coins-currency) | **Docs:** [parse.bot/marketplace/5f9dd8a6-86c9-45da-a69b-6b80fdfb7d79/littletoncoin-com-api](https://parse.bot/marketplace/5f9dd8a6-86c9-45da-a69b-6b80fdfb7d79/littletoncoin-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/littleton-coin-company/`
**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 product

Retrieve full details for a single product by its part number, including description, images, and available SKU variants with their grades and prices.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `part_number` | string | Yes | Product part number (e.g. '1639-wc', 'A4200EZ-wc'). Obtain from search_products results. |

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

### List categories

List product categories. Without parent_id, returns the top-level category tree with immediate children. With parent_id, returns the direct children of that category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `parent_id` | string | No | Parent category ID to list children of. Omit to get the full top-level tree. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/littleton-coin-company/list-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"parent_id":"<string>"}'
```

### Search products

Search or browse products by keyword and/or category. Returns paginated results with total count. Combine query and category_id to narrow results within a category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Category ID to browse products within a specific category. Obtain from list_categories. |
| `limit` | integer | No | Number of results per page (max 96). |
| `offset` | integer | No | Number of results to skip for pagination. |
| `query` | string | No | Free-text search term (e.g. 'morgan dollar', 'quarter'). At least one of query or category_id is required. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/littleton-coin-company/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","limit":"<integer>","offset":"<integer>","query":"<string>","sort":"<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.