---
title: "Lista de títulos do Tesouro Direto"
method: GET
path: "/api/v2/treasury/list"
tags: ["Renda Fixa"]
---

# Lista de títulos do Tesouro Direto

`GET /api/v2/treasury/list`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/treasury/list`
- Auth: HTTP bearer

Títulos do Tesouro Direto da data-base mais recente, com taxa e preço
indicativos de compra e venda. Filtre por indexador, tipo de cupom ou nome.

Use para achar o `symbol` de cada título, montar uma tabela de títulos ou
comparar taxas entre vencimentos.

Cada item traz `rateInfo`, que diz como ler `buyRate` e `sellRate`
para aquele indexador.

Plano Pro. Sem token, `search` precisa ser um destes códigos:
`tesouro-selic-01032031`, `tesouro-prefixado-com-juros-semestrais-01012037`
ou `tesouro-ipca-com-juros-semestrais-15082060`.

## Query parameters

- `page` integer: Número da página, a partir de 1.
- `limit` integer: Itens por página.
- `search` string: Busca por parte do código ou do nome do título. Ex.: tesouro-selic-01032031.
- `indexer` 'selic' | 'prefixado' | 'ipca' | 'igpm': Indexador do título.
- `couponType` 'zero' | 'semestral': Tipo de cupom do título.
- `sortBy` 'symbol' | 'bondType' | 'maturityDate' | 'durationDays' | 'baseDate' | 'buyRate' | 'sellRate' | 'buyPrice' | 'sellPrice' | 'basePrice': Campo usado na ordenação.
- `sortOrder` 'asc' | 'desc': Direção da ordenação.

## Response `200`

Lista paginada de títulos do Tesouro Direto

- TreasuryListResponse
  - `results` TreasuryListItem[], required
    - `symbol` string, required: Código do título: nome e vencimento em DDMMAAAA.
    - `bondType` string, required: Nome do título no Tesouro Direto.
    - `indexer` 'selic' | 'prefixado' | 'ipca' | 'igpm', required: Indexador do título. Renda+ e Educa+ usam `ipca`.
    - `couponType` 'zero' | 'semestral', required: `semestral` para títulos com juros semestrais, `zero` para os demais.
    - `maturityDate` string, nullable, required: Data de vencimento, no formato YYYY-MM-DD.
    - `durationDays` number, nullable, required: Dias corridos da data-base até o vencimento.
    - `baseDate` string, nullable, required: Data da taxa e do preço, no formato YYYY-MM-DD.
    - `buyRate` number, nullable, required: Taxa indicativa de compra, em % a.a. O sentido muda por indexador. Veja `rateInfo`.
    - `sellRate` number, nullable, required: Taxa indicativa de venda, em % a.a. O sentido muda por indexador. Veja `rateInfo`.
    - `buyPrice` number, nullable, required: Preço unitário indicativo de compra, em reais.
    - `sellPrice` number, nullable, required: Preço unitário indicativo de venda, em reais.
    - `basePrice` number, nullable, required: Preço unitário base, em reais.
    - `rateInfo` object, required: Como ler `buyRate` e `sellRate`. O sentido muda por indexador.
      - `rateType` 'spreadOverSelic' | 'nominalAnnualRate' | 'realAnnualRateOverIpca' | 'realAnnualRateOverIgpm', required: O que `buyRate` e `sellRate` medem.
      - `rateUnit` string, required: Unidade de `buyRate` e `sellRate`.
      - `description` string, required: Texto que explica como ler `buyRate` e `sellRate` neste título.
  - `pagination` TreasuryPaginationMeta, required
    - `page` number, required
    - `limit` number, required
    - `totalItems` number, required
    - `totalPages` number, required
    - `hasNextPage` boolean, required
  - `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.
- `429`: Limite de requisições excedido.
- `500`: Erro interno do servidor.
- `503`: Serviço temporariamente indisponível. Tente de novo em alguns minutos.

## Changes

- **2026-08-21** `d51b6ee0304a`: 1 info
  - api operation id `listTreasury` was added
- **2026-05-22** `88caa8b47894`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/treasury/list/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)
