# Namecheap — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for available domain names, check their registration status, and browse TLD pricing across different extensions. Discover discounted domains on the marketplace and explore hosting bundles to find the perfect combination for your website needs.

**Category:** Developer Tools | **Website:** [namecheap.com/](https://namecheap.com/) | **Docs:** [parse.bot/marketplace/dfad2425-ccc9-4e8e-9c09-f61f119d1a97/namecheap-com-api](https://parse.bot/marketplace/dfad2425-ccc9-4e8e-9c09-f61f119d1a97/namecheap-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/namecheap/`
**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

### Check domain status

Check marketplace availability status for a list of specific domains. Returns each domain's marketplace status (active if listed, notfound if not on marketplace). This checks marketplace presence, not general registration availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domains` | string | Yes | Comma-separated list of domains to check (e.g. 'google.com,test.ai'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/namecheap/check-domain-status \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"domains":"<string>"}'
```

### Get hosting bundles

List web hosting plan bundles that include free or discounted domains. Returns bundle details with pricing for both hosting and domain components, including renewal pricing and duration.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product` | string | No | Hosting plan name to get bundles for. |

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

### Get market home

Get popular and featured domain collections from the Namecheap marketplace homepage. Returns themed collections (Popular, Closeouts, AI, etc.) with their top auction listings, plus aggregate sale counts.

**Estimated cost:** Metered

_No parameters required._

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

### List tld prices

Get comprehensive pricing for all TLDs (generic and country-code), including registration, renewal, and promotional hints. Returns an array of TLD objects with pricing details. Each TLD includes its type (GTLD or CCTLD), categories, and year limits for registration.

**Estimated cost:** Metered

_No parameters required._

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

### Search market auctions

Search and list active domains in Namecheap marketplace auctions. Returns auction details like current price, bid count, end date, and domain valuation metrics. Results are paginated by page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | No | Search term to filter auction domains by name. |
| `limit` | integer | No | Maximum items per page. |
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sorting criteria for results. |

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

## Next steps

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