# Infomoney — 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 Brazilian stocks, currencies, and cryptocurrencies with real-time quotes, historical OHLCV data, fundamentals, and dividends. Access intraday price movements, top B3 movers, exchange rates, and market news from InfoMoney.

**Category:** Finance & Markets | **Website:** [infomoney.com.br/](https://infomoney.com.br/) | **Docs:** [parse.bot/marketplace/55a06703-e126-4da1-920f-0deee0aca7a0/infomoney-com-br-api](https://parse.bot/marketplace/55a06703-e126-4da1-920f-0deee0aca7a0/infomoney-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-infomoney-com-br-api-55a06703/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_b3_top_movers

Get top gainers or losers for the IBOV index. Returns 10 stocks with the highest or lowest daily change percentage, including current price, OHLC, and volume data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `index` | string | No | B3 index code. Only 'IBOV' is supported. |
| `order` | string | No | Sort order: 'Desc' for top gainers, 'Asc' for top losers |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-infomoney-com-br-api-55a06703/get_b3_top_movers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"index":"<string>","order":"<string>"}'
```

### get_crypto_rates

Get current rates for cryptocurrencies in BRL. Returns price and daily change percentage. Supports Bitcoin, Ethereum, and other major cryptocurrencies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbols` | string | No | Comma-separated cryptocurrency names (e.g. Bitcoin,Ethereum) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-infomoney-com-br-api-55a06703/get_crypto_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbols":"<string>"}'
```

### get_currency_rates

Get current exchange rates for major currencies against BRL. Returns bid and ask prices with timestamp. Supports USD, EUR, GBP, and other currencies available on the B3 exchange.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbols` | string | No | Comma-separated currency symbols (e.g. USD,EUR,GBP) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-infomoney-com-br-api-55a06703/get_currency_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbols":"<string>"}'
```

### get_stock_dividends

Get dividend and corporate event history for a stock over a specified number of months. Returns records including event type (DIVIDENDO, JRSCAPPROPRIO, RENDIMENTO), rate per share, dividend yield, and relevant dates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `months` | integer | No | Number of months of history to fetch (e.g. 6, 12, 24) |
| `ticker` | string | No | B3 stock ticker symbol (e.g. PETR4, VALE3, ITUB4) |

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

### get_stock_fundamentals

Get fundamental financial indicators for a stock including profitability ratios (ROE, ROIC, net margin, EBITDA margin), debt metrics (gross debt, net debt), and valuation multiples (P/E). Data comes from the latest financial statement available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | No | B3 stock ticker symbol (e.g. PETR4, VALE3, ITUB4) |

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

### get_stock_historical_data

Get historical daily OHLCV data with pagination. Returns a result array and hasNextPage flag indicating if more pages are available. Each page contains up to page_size records ordered by most recent first.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based) |
| `page_size` | integer | No | Number of results per page (1-100) |
| `ticker` | string | No | B3 stock ticker symbol (e.g. PETR4, VALE3, ITUB4) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-infomoney-com-br-api-55a06703/get_stock_historical_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","ticker":"<string>"}'
```

### get_stock_intraday

Get intraday high-frequency data at a configurable periodicity. Returns OHLCV data for each time bucket. Covers the current trading day or the last five trading days depending on the interval parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `interval` | string | No | Time range: 'OneDay' for current day, 'FiveDays' for last five trading days |
| `periodicity` | integer | No | Frequency in minutes per data point (e.g. 1, 5, 15, 60) |
| `ticker` | string | No | B3 stock ticker symbol (e.g. PETR4, VALE3, ITUB4) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-infomoney-com-br-api-55a06703/get_stock_intraday \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"interval":"<string>","periodicity":"<integer>","ticker":"<string>"}'
```

### get_stock_last_15_days

Get stock values for the last 15 business days at daily resolution. Returns an array of OHLCV records ordered by most recent first. Each record includes open, high, low, close prices, daily change percentage, trade volume, and financial volume.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | No | B3 stock ticker symbol (e.g. PETR4, VALE3, ITUB4) |

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

### get_stock_news

Get recent news articles related to a stock ticker from InfoMoney. Returns article metadata including title, excerpt, publication date, and link. Articles are ordered by most recent first.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return (1-100) |
| `ticker` | string | No | Stock ticker or keyword to search news for |

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

### get_stock_quote

Get the current intraday quote for a stock, including last traded price, daily open/high/low/close, change percentages (daily, monthly, yearly, 52-week), average price, volume, and number of trades.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | No | B3 stock ticker symbol (e.g. PETR4, VALE3, ITUB4) |

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