# Investidor10 — 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 comprehensive Brazilian stock and real estate investment fund data including listings, technical indicators, dividend history, and historical price quotes. Search and retrieve detailed information about individual assets to analyze their performance and financial metrics.

**Category:** Finance & Markets | **Website:** [investidor10.com.br/](https://investidor10.com.br/) | **Docs:** [parse.bot/marketplace/fe86bbfe-6a00-46ea-897f-b5c3a3ec7dbf/investidor10-com-br-api](https://parse.bot/marketplace/fe86bbfe-6a00-46ea-897f-b5c3a3ec7dbf/investidor10-com-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-investidor10-com-br-api-fe86bbfe/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_acao_cotacao_historico

Get historical price chart data for a stock ticker in BRL, USD, and EUR. Returns arrays of price points with timestamps for each currency.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `days` | integer | No | Number of days of price history to retrieve. |
| `ticker` | string | Yes | Stock ticker symbol (e.g. PETR4, VALE3). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-investidor10-com-br-api-fe86bbfe/get_acao_cotacao_historico \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":"<integer>","ticker":"<string>"}'
```

### get_acao_detalhes

Get detailed information for a specific stock ticker, including current price, fundamental indicators (P/L, P/VP, ROE, Dividend Yield, margins, etc.), internal IDs, and recent dividend history with payment dates and values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | Stock ticker symbol (e.g. PETR4, VALE3, ITUB4). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-investidor10-com-br-api-fe86bbfe/get_acao_detalhes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>"}'
```

### get_acao_historico_indicadores

Get historical fundamental indicators for a stock ticker over a period of years. Returns yearly values for each indicator (P/L, P/VP, ROE, Dividend Yield, margins, etc.) including the current value and past years with metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | Stock ticker symbol (e.g. PETR4, VALE3). |
| `years` | integer | No | Number of years of history to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-investidor10-com-br-api-fe86bbfe/get_acao_historico_indicadores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>","years":"<integer>"}'
```

### list_acoes

List top Brazilian stocks ranked by market value with fundamental indicators. Returns up to 80 stocks from the main rankings page. Each stock includes ticker, company name, market cap, P/L, P/VP, dividend yield, ROE, net margin, and sector.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `length` | integer | No | Maximum number of results to return. |
| `start` | integer | No | Starting index for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-investidor10-com-br-api-fe86bbfe/list_acoes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"length":"<integer>","start":"<integer>"}'
```

### list_fiis

List top FIIs (Real Estate Investment Funds) ranked by market value. Returns up to 80 FIIs from the main rankings page. Each FII includes ticker, name, market cap, P/VP, dividend yield, daily liquidity, and sector.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `length` | integer | No | Maximum number of results to return. |
| `start` | integer | No | Starting index for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-investidor10-com-br-api-fe86bbfe/list_fiis \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"length":"<integer>","start":"<integer>"}'
```

### search_ativos

Search for assets (stocks, FIIs, BDRs, etc.) by name or ticker symbol. Returns matching assets with price and variation data, plus related news articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string (ticker symbol or company name). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-investidor10-com-br-api-fe86bbfe/search_ativos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```