# Status Invest Brazil Market Calendar API

> Brazilian stocks and REITs: dividend dates, payments, earnings releases, meetings, IPOs by month

- Vendor: `statusinvestbrazilmarketcalend` · version 1.0 · category Finance · tags brazil dividends api, b3 calendar api, fii dividends api, earnings calendar api, brazil stocks api, dividend dates api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/statusinvestbrazilmarketcalend
- This document: https://apiclay.com/docs/statusinvestbrazilmarketcalend.md
- OpenAPI 3.1: https://apiclay.com/api/statusinvestbrazilmarketcalend/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `statusinvestbrazilmarketcalend`
- Updated: 2026-11-18

## About

## Status Invest Brazil Market Calendar API

One month of the Brazilian market calendar from Status Invest: dividend and JCP declarations with record date, payment date and amount per share, earnings releases, shareholder meetings, IPOs and market holidays, for B3 stocks and real-estate funds (FIIs).

Data comes from **statusinvest.com.br** (https://statusinvest.com.br). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://statusinvest.com.br) and returns it unchanged.

Typical flow: `/calendar?type=2&amp;country=0&amp;year=2026&amp;month=11`, optionally narrowed with `companyname`.

### Routes

#### GET `/calendar` - Monthly market calendar
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| type | query | number | yes | `1` or `2`: the two calendar views the site uses (both return dividends, reports and meetings). |
| country | query | number | no | `0` (Brazil) as the site uses it. |
| year | query | number | yes | e.g. `2026`. |
| month | query | number | yes | 1-12. |
| companyname | query | string | no | Filter by company; the site sends it with `companyid` (a name alone can return no events). |
| companyid | query | string | no | Status Invest company id. |

Returns: `provents[]` (`code`, `companyName`, `resultAbsoluteValue`, `dateCom`, `paymentDividend`, `earningType`), `proventsPayment[]`, `reports[]`, `meetings[]`, `iPOs[]`, `holidays[]`, `totalEvents`.

### Caveats

- A full month is 170-260 KB.
- Amounts use a comma decimal separator (`0,0600`).
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by statusinvest.com.br.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /calendar — Monthly market calendar
- Gateway: `GET https://api.apiclay.com/v1/api/statusinvestbrazilmarketcalend/calendar`
- Public query params: `type` (number, required), `country` (number), `year` (number, required), `month` (number, required), `companyname` (string), `companyid` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/statusinvestbrazilmarketcalend/calendar?type=<type>&year=<year>&month=<month>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
