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

# Lista títulos do Tesouro Direto

`GET /api/v2/treasury/list`

Retorna os títulos do Tesouro Direto atualmente ofertados, com taxas e preços indicativos mais recentes. Requer plano Pro, exceto pelos três títulos sandbox documentados.

## Query parameters

- `page` integer — Página (começa em 1)
- `limit` integer — Itens por página
- `search` string — Busca por símbolo público do Tesouro Direto ou nome do título. Exemplo: tesouro-selic-01032031
- `indexer` 'selic' | 'prefixado' | 'ipca' | 'igpm' — Filtra pelo indexador do título
- `couponType` 'zero' | 'semestral' — Filtra pelo tipo de cupom
- `sortBy` 'symbol' | 'bondType' | 'maturityDate' | 'durationDays' | 'baseDate' | 'buyRate' | 'sellRate' | 'buyPrice' | 'sellPrice' | 'basePrice' — Campo para 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 — Slug público do título do Tesouro Direto
    - `bondType` string, required — Nome público do título
    - `indexer` 'selic' | 'prefixado' | 'ipca' | 'igpm', required — Indexador normalizado do título
    - `couponType` 'zero' | 'semestral', required — Tipo de pagamento de juros do título
    - `maturityDate` string, nullable, required — Data de vencimento no formato YYYY-MM-DD
    - `durationDays` number, nullable, required — Dias corridos entre a data-base e o vencimento
    - `baseDate` string, nullable, required — Data-base da cotação no formato YYYY-MM-DD
    - `buyRate` number, nullable, required — Taxa indicativa de compra em % a.a. Unidade: Tesouro Selic = spread (% a.a.) sobre a taxa Selic; Tesouro Prefixado = rendimento nominal (% a.a.); Tesouro IPCA = rendimento real (% a.a.) acima do IPCA.
    - `sellRate` number, nullable, required — Taxa indicativa de venda em % a.a. Unidade: Tesouro Selic = spread (% a.a.) sobre a taxa Selic; Tesouro Prefixado = rendimento nominal (% a.a.); Tesouro IPCA = rendimento real (% a.a.) acima do IPCA.
    - `buyPrice` number, nullable, required — Preço unitário indicativo de compra em BRL
    - `sellPrice` number, nullable, required — Preço unitário indicativo de venda em BRL
    - `basePrice` number, nullable, required — Preço unitário base em BRL
    - `rateInfo` object, required — Metadados para interpretar buyRate e sellRate. As taxas têm significados diferentes conforme o indexador.
      - `rateType` 'spreadOverSelic' | 'nominalAnnualRate' | 'realAnnualRateOverIpca' | 'realAnnualRateOverIgpm', required — Tipo de interpretação para buyRate e sellRate
      - `rateUnit` string, required — Unidade das taxas buyRate e sellRate
      - `description` string, required — Descrição textual de como interpretar buyRate e sellRate para o indexador do 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 formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso negado
- `404` — Não encontrado
- `429` — Limite de requisições excedido
- `500` — Erro interno do servidor
- `503` — Serviço externo temporariamente indisponível

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/versions/f275d46193ea/schema)
