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

> Track current and historical egg prices across India's 1600+ cities and 34 major markets, with breakdowns by market type (NECC, Wholesale, Retail, and Super Market). Search specific locations or browse rates by state to monitor price trends and compare prices across different market channels.

**Category:** Food & Dining | **Website:** [todayeggrate.in/](https://todayeggrate.in/) | **Docs:** [parse.bot/marketplace/d7ee4f57-1382-4a6a-a0a2-36a18b785ad3/todayeggrate-in-api](https://parse.bot/marketplace/d7ee4f57-1382-4a6a-a0a2-36a18b785ad3/todayeggrate-in-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/todayeggrate/`
**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 market rates

Get detailed egg rates for a specific city, market, or state including 10-day price history and rate breakdown by market type (NECC, Wholesale, Retail, Super Market). The '-egg-rate' suffix is added automatically if missing from the slug. Returns the full title, category classification, and both historical daily prices and current channel-specific rates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Market slug (e.g., 'barwala', 'delhi', 'andhra-pradesh', 'mumbai-egg-rate'). The '-egg-rate' suffix is added automatically if missing. |

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

### Get today rates

Get today's egg rates for all 34 major markets across India, plus national average rates by market type (NECC, Wholesale, Retail, Super Market). Returns current date, per-market prices (piece, tray, 100 pcs, peti), and averaged rates across all markets broken down by channel. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### List markets

List all available markets, cities, or states with pagination support. Returns paginated results ordered by last update time. Each item includes the name, slug, title, link, and last update timestamp.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category to list: 'market', 'state', or 'city'. |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Results per page (max 100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/todayeggrate/list-markets \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>","per_page":"<integer>"}'
```

### Search markets

Search for cities, markets, or states by name. Performs exact slug match first, then partial substring matching across all categories. Returns matching items with their name, slug, title, category classification, link, and last update time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Optionally filter by category: 'market', 'state', or 'city'. Empty string searches all categories. |
| `limit` | integer | No | Maximum number of results to return (max 100). |
| `query` | string | Yes | Search term (e.g., 'delhi', 'tamil', 'mumbai', 'andhra'). |

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