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

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ccee-org-br-api-5070879f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-ccee-org-br-api-5070879f/get_filter_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-ccee-org-br-api-5070879f/get_pld_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-ccee-org-br-api-5070879f/search_atas_cad \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-ccee-org-br-api-5070879f/search_documents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"assunto":"<string>","end_date":"<string>","especie":"<string>","limit":"<integer>","page":"<integer>","query":"<string>","start_date":"<string>"}'
```