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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-todayeggrate-in-api-d7ee4f57/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-todayeggrate-in-api-d7ee4f57/get_market_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-todayeggrate-in-api-d7ee4f57/get_today_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-todayeggrate-in-api-d7ee4f57/list_markets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-todayeggrate-in-api-d7ee4f57/search_markets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>","query":"<string>"}'
```