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

> Access real-time electricity spot prices (PLD) and search CCEE documents and board meeting minutes to stay informed on Brazil's energy market. Filter and retrieve current pricing data and historical meeting records to track energy market developments.

**Category:** Finance & Markets | **Website:** [ccee.org.br/](https://ccee.org.br/) | **Docs:** [parse.bot/marketplace/5070879f-c939-4630-95a1-76c970e7fc5e/ccee-org-br-api](https://parse.bot/marketplace/5070879f-c939-4630-95a1-76c970e7fc5e/ccee-org-br-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/ccee/`
**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 filter options

Retrieve the complete list of accepted filter values for the search_documents endpoint. Returns all document types (especies) and subjects (assuntos) that can be passed as the especie and assunto parameters respectively. Values are returned as sorted arrays of Portuguese-language strings.

**Estimated cost:** Metered

_No parameters required._

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

### Get pld prices

Get current PLD (Preço de Liquidação das Diferenças) electricity spot prices from the CCEE homepage. Returns hourly and daily average prices in R$/MWh for each of the four Brazilian electricity submarkets (SE/CO, S, NE, N). Prices update hourly; the response includes the current time window.

**Estimated cost:** Metered

_No parameters required._

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

### Search atas cad

Search for Board Meeting Minutes (Atas do CAD) and Board of Directors Minutes from CCEE. Returns paginated results of administration council and directorship meeting minutes. Covers the full historical archive back to 2000. Each result includes the minute's name, description, publication date, download URL, and hash.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number (0-indexed). |
| `query` | string | No | Search keyword to filter meeting minutes. |

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

### Search documents

Search the CCEE Acervo (document repository) with keyword and filters. Returns paginated results sorted by publication date descending. When no date range is provided, defaults to the last 365 days. Each result includes document metadata (name, type, size, description, publication date, download URL, and hash). Supports filtering by document type (especie) and subject (assunto) using values from get_filter_options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `assunto` | string | No | Subject filter. Accepted values available from the get_filter_options endpoint (e.g. 'PLD', 'Conselho de Administração', 'Leilão', 'Mercado de Energia'). |
| `end_date` | string | No | End date for publication filter in DD/MM/YYYY format. |
| `especie` | string | No | Document type filter. Accepted values available from the get_filter_options endpoint (e.g. 'Ata', 'Relatório', 'Resolução', 'Edital', 'Manual'). |
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number (0-indexed). |
| `query` | string | No | Search keyword to filter documents by title or content. |
| `start_date` | string | No | Start date for publication filter in DD/MM/YYYY format. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/ccee/search-documents \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"assunto":"<string>","end_date":"<string>","especie":"<string>","limit":"<integer>","page":"<integer>","query":"<string>","start_date":"<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.