# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-littletoncoin-com-api-5f9dd8a6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-littletoncoin-com-api-5f9dd8a6/get_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-littletoncoin-com-api-5f9dd8a6/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-littletoncoin-com-api-5f9dd8a6/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","limit":"<integer>","offset":"<integer>","query":"<string>","sort":"<string>"}'
```