Symbols

To optimize your symbol lookup . Find the main group ticker.
GET
/symbol/:id

Query Parameters

Attribute
Description
Default
locales
Defines the company's description language.
Options: pt-br, en.
En

Path Variables

Attribute
Description
Default
id
Ticker’s code that bring details, among these, what’s the main group of ticker.
OBS 1
This is a paginated endpoint. Refer to pagination documentation for more details on how to use.

Response


{
  "data": {
    "sectors": [
      "Industrials",
      "Engineering & Construction Svcs",
      "Industrial Services"
    ],
    "exchange_short": "B3",
    "name": "Cury",
    "currency": "BRL",
    "exchange": "Brasil Bolsa Balcão S.A.",
    "id": "CURY3",
    "nicknames": [
      "construtora cury",
      "cury construtora"
    ],
    "sector": "Industrials",
    "total_shares": "291875088",
    "cvm_code": "025100",
    "main_ticker": "CURY3",
    "website": "https://cury.net/",
    "registration_number": "08.797.760/0001-83",
    "description": "Cury is a Brazilian construction company operating in civil...\n",
    "website_ir": "https://ri.cury.net/",
    "corporate_name": "Cury Construtora e Incorporadora SA",
    "gics_industry": "20103010",
    "gics_sub_industry": "20103010",
    "history": [
      {
        "symbol": "CURY3",
        "timestamp": "2021-08-02",
        "min": 910,
        "max": 948,
        "marketCapStat": {
          "high": 276697583424,
          "low": 265606330080,
          "close": 275530083072,
          "open": 266773830432
        },
        "close": 944,
        "volume": 540000,
        "marketCap": 275530083072,
        "open": 914
      },
      {
      "symbol": "CURY3",
      "timestamp": "2021-08-03",
      "min": 906,
      "max": 923,
      "marketCapStat": {
        "high": 269400706224,
        "low": 264438829728,
        "close": 265314454992,
        "open": 268525080960
      },
      "close": 909,
      "volume": 513700,
      "marketCap": 265314454992,
      "open": 920
      }
    ],
    "finance": {
      "date": "2021-08-30",
      "symbol": "CURY3",
      "market_cap": 2405051,
      "net_debt": -221692,
      "ev": 2333491,
      "revenue": 1461781,
      "ebitda": null,
      "ebitda_margin": null,
      "gross_margin": 37.4,
      "net_debt__ebitda": null,
      "ev__ebitda": null,
      "ev__revenue": 1.6,
      "pl": 9.6,
      "price__equity_value": 4.4,
      "net_profit": 245919,
      "ebitda_yoy": 0,
      "revenue__yoy": 1.434135176208234,
      "net_profit__yoy": 1.5357651378896882,
      "net_margin": 18,
      "dividend_yield": null,
      "roic": 27.7,
      "net_worth": 541253,
      "price_to_book": 4.4
      }
  }
}
GET
/symbol

Query Parameters

Attribute
Description
Default
term
Search information by the company's name, description, tag.
OBS 1
This is a paginated endpoint. Refer to pagination documentation for more details on how to use.

Response


{
  "data": [
    {
      "id": "DISB34",
      "currency": "BRL",
      "name": "Disney",
      "exchange_short": "B3",
      "exchange": "Brasil Bolsa Balcão S.A.",
      "sectors": [
        "Entertainment"
      ],
      "sector": "Communications",
      "nicknames": [
        "walt disney",
        "disney+"
      ],
      "total_shares": "27105000000",
      "cvm_code": "050393",
      "main_ticker": "DISB34",
      "website": "https://thewaltdisneycompany.com/",
      "registration_number": "83-0940635",
      "description": "The Walt Disney Company, or simply Disney, is an entertainment company with operations in mass media networks, by Walt Disney Studios, considered one of the largest media and entertainment conglomerates in the world. The company also has experiences in parks and consumer products, studio entertainment and Direct-to-Consumer networks and channels.\n",
      "website_ir": "https://thewaltdisneycompany.com/investor-relations/",
      "corporate_name": "The Walt Disney Company",
      "gics_industry": "502020",
      "gics_sub_industry": "50202010"
    }
  ],
  "pagination": {
    "current": 1,
    "items": 1,
    "pages": 1
  }
}
GET
/symbol/:id/fund-investors

Query Parameters

Attribute
Description
Default
locales
Defines the company's description language.
Options: pt-br, en.
En

Path Variables

Attribute
Description
Default
funds
List of fund documents. Comma separated. Only digits.
from
First date.
Format: YYYY-MM-DD
Last month
to
Ending date.
Format: YYYY-MM-DD
Last month
OBS 1
This is a paginated endpoint. Refer to pagination documentation for more details on how to use.

Response

Attribute
Description
Default
operation_type
Codes for each operation type:

1 - Brazilian Depository Receipt - BDR
2 - Debêntures
3 - Ações
4 - Obrigações por ações e outros TVM recebidos em empréstimo
5 - Ações e outros TVM cedidos em empréstimo
6 - Vendas a termo a receber
7 - Compras a termo a receber
8 - Opções - Posições lançadas
9 - Opções - Posições titulares
10 - Certificado ou recibo de depósito de valores mobiliários
11 - Outros valores mobiliários registrados na CVM objeto de oferta pública
12 - Mercado Futuro - Posições vendidas
13 - Mercado Futuro - Posições compradas
trade_type
Code for trade purpose:

1 - Para negociação
2 - Mantido até o vencimento
connection
Indicates wether the trade is connected with the fund manager or administrator.
sell_amount
Total value in reais.
buy_amount
Total value in reais.
group
4 - General coded assets (company stocks in general, but not only)
{
  "data": [
    {
      "document": "21917206000150",
      "date": "2021-05-31",
      "operation_type": 3,
      "asset_type": "Ação ordinária",
      "connection": false,
      "trade_type": 1,
      "sell_quantity": 1040000,
      "sell_amount": 8770217,
      "buy_quantity": 340000,
      "buy_amount": 3061608,
      "portfolio_amount": 2300000,
      "portfolio_market_value": 21850000,
      "confidenciality_due": "2021-08-29",
      "symbol": "AERI3",
      "isin": "BRAERIACNOR4",
      "term_start_date": "2020-11-11",
      "group": "4"
    }
  ],
  "pagination": {
    "current": 1,
    "items": 5000,
    "pages": 198
  }
}