--- title: "Posições em aberto de opções sobre futuros" method: GET path: "/api/v2/futures/options/positions" tags: ["Opções sobre Futuros"] --- # Posições em aberto de opções sobre futuros `GET /api/v2/futures/options/positions` ## Request - Base URL: `https://brapi.dev` - URL: `https://brapi.dev/api/v2/futures/options/positions` - Auth: HTTP bearer Retorna os contratos em aberto de cada série de opções sobre futuro de um vencimento. Use para ver onde se concentram as posições por strike, comparar calls e puts e acompanhar a variação diária de contratos em aberto. Use `openInterest` como número de contratos em aberto. Aqui ele repete `reportedOpenInterest`. Os campos de posição coberta, descoberta, bloqueada e de empréstimo vêm vazios na maior parte dos segmentos de futuros. Volume e contratos em aberto medem coisas diferentes: uma série pode ficar sem negócio e ter muitos contratos em aberto. Os contratos em aberto são apurados uma vez por pregão. Sem apuração na data pedida, a resposta traz a anterior. Confira `openInterestDate` antes de comparar com o preço do dia. Aceita os mesmos filtros da [cadeia de opções sobre futuros](https://brapi.dev/docs/futuros/opcoes/series): `side`, `minStrike` e `maxStrike`. Disponível no plano Pro. Sem token, aceita só `underlying=BGI`. ## Query parameters - `underlying` string, required: Código do ativo do futuro. Ex.: `BGI`. - `expirationDate` string, required: Data de vencimento, no formato YYYY-MM-DD. Veja os vencimentos em `/expirations`. - `date` string: Data do pregão, no formato YYYY-MM-DD. Padrão: último pregão disponível. - `side` 'call' | 'put': Filtra por `call` ou `put`. Sem o filtro, retorna os dois. - `minStrike` number, nullable: Strike mínimo. - `maxStrike` number, nullable: Strike máximo. ## Response `200` Posições retornadas com sucesso. - FutureOptionPositionsResponse - `underlying` string, required - `expirationDate` string, required - `date` string, required - `positions` FutureOptionPositionSnapshot[], required - `symbol` string, required: Código da série de opção. Ex.: `BGIH27C028550`. - `underlyingAsset` string, required: Código do ativo do futuro. Ex.: `BGI`. - `underlyingFuture` string, nullable, required: Contrato futuro de base, quando informado. - `optionType` 'call' | 'put', required: `call` (opção de compra) ou `put` (opção de venda). - `optionStyle` 'american' | 'european', nullable, required: `american` permite exercício até o vencimento. `european` permite exercício só no vencimento. - `segment` 'financial' | 'agribusiness', required: Segmento do contrato: `financial` ou `agribusiness`. - `strike` number, required: Preço de exercício da opção, na unidade de cotação do futuro. - `expirationDate` string, required: Data de vencimento, no formato YYYY-MM-DD. - `firstTradeDate` string, nullable, required: Data do primeiro pregão da série, no formato YYYY-MM-DD. - `lastTradeDate` string, nullable, required: Data do último pregão da série, no formato YYYY-MM-DD. - `contractMultiplier` number, nullable, required: Multiplicador do contrato, herdado do futuro. Ex.: 330 arrobas no boi gordo. - `allocationRoundLot` integer, nullable, required: Lote padrão de negociação. - `exerciseType` string, nullable, required: Tipo de exercício. - `automaticExercise` boolean, nullable, required: `true` quando a opção é exercida automaticamente no vencimento. - `premiumUpfront` boolean, nullable, required: `true` se o prêmio é pago à vista, `false` se é diferido. - `isin` string, nullable, required: Código ISIN da série de opção, não do contrato futuro. - `cficCode` string, nullable, required: Código CFI. - `openInterest` number, nullable, required: Contratos em aberto na série, na última apuração até a data pedida. - `openInterestChange` number, nullable, required: Variação de contratos em aberto desde a apuração anterior. - `openInterestDate` string, nullable, required: Data da apuração usada, no formato YYYY-MM-DD. Pode ser anterior à data do pregão. - `reportDate` string, required: Data da apuração, no formato YYYY-MM-DD. - `asset` string, nullable, required: Código raiz do ativo objeto. Ex.: BGI. - `expirationCode` string, nullable, required: Código de vencimento da apuração. Ex.: VVNK. - `reportSegment` string, required: Segmento da apuração. Ex.: AGRIBUSINESS. É diferente do campo `segment` do contrato. - `reportedOpenInterest` number, nullable, required: Contratos em aberto na apuração do pregão. É a origem de `openInterest`. - `reportedOpenInterestChange` number, nullable, required: Variação de contratos em aberto na apuração do pregão. É a origem de `openInterestChange`. - `distributionId` string, nullable, required: Número de distribuição do ativo objeto. Vem vazio nas opções sobre futuros. - `coveredQuantity` number, nullable, required: Contratos em posição coberta. - `blockedQuantity` number, nullable, required: Contratos em posição bloqueada. - `uncoveredQuantity` number, nullable, required: Contratos em posição descoberta. - `totalPositionQuantity` number, nullable, required: Total de contratos em posição. Vem vazio na maior parte dos segmentos de futuros. - `borrowerQuantity` number, nullable, required: Quantidade tomadora em empréstimo de ativos. - `lenderQuantity` number, nullable, required: Quantidade doadora em empréstimo de ativos. - `currentQuantity` number, nullable, required: Quantidade corrente. Preenchida só em alguns segmentos. - `forwardPrice` number, nullable, required: Preço a termo. Preenchido só em alguns segmentos. - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601. - `took` integer, required: Tempo de processamento, em milissegundos. ## Other responses - `400`: Requisição inválida. Confira os parâmetros. - `401`: Token ausente ou inválido. - `403`: O plano não inclui este recurso ou parâmetro. - `404`: Nenhum dado encontrado para o pedido. - `500`: Erro interno do servidor. ## Changes - **2026-08-29** `40fae0b2d5fb`: 1 info - endpoint added [Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/futures/options/positions/get.md) --- [API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)