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

> Retrieve hourly electricity prices, current outage summaries, rate information, and energy efficiency programs from Ameren. Covers Illinois and Missouri service areas with real-time and forecast pricing data.

**Category:** Government & Public Data | **Website:** [ameren.com/](https://ameren.com/) | **Docs:** [parse.bot/marketplace/f386995a-ef32-4f92-aef1-4d12b359e1ea/ameren-com-api](https://parse.bot/marketplace/f386995a-ef32-4f92-aef1-4d12b359e1ea/ameren-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/ameren/`
**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 efficiency programs

Get links and information for energy efficiency rebate programs available to Ameren customers. Programs include rebates for appliances, insulation, HVAC, and lighting.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | No | Service state. |

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

### Get hourly prices

Get hourly electricity prices for a specific date. If no date is provided, defaults to the current day. Prices are in $/kWh. Historical dates going back several months are supported.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Target date in YYYY-MM-DD format. Omitting returns today's prices. |

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

### Get hourly prices previous day

Get the prior day's hourly electricity prices. Returns the full 24-hour price table for yesterday in $/kWh.

**Estimated cost:** Metered

_No parameters required._

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

### Get hourly prices today

Get today's 24-hour wholesale electricity price table for Illinois. Returns hourly price data for each hour of the current day. Prices are in $/kWh.

**Estimated cost:** Metered

_No parameters required._

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

### Get hourly prices tomorrow

Get tomorrow's hourly electricity prices. Prices are typically available after approximately 5:30 PM CT. Returns null for prices if not yet available.

**Estimated cost:** Metered

_No parameters required._

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

### Get outage summary

Get current outage summary data for Illinois and Missouri service areas. Returns the number of active outages, affected customers, and network availability percentage for each region. Data refreshes every few minutes.

**Estimated cost:** Metered

_No parameters required._

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

### Get rates info

Get links and basic information about residential or business rates for Illinois or Missouri service areas. Returns a URL to the rates page along with a description of available content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Rate category. |
| `state` | string | No | Service state. |

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