Listar Fundos

GET

/traded-funds

Retorna a lista de fundos listados disponíveis na Partnr API (ex.: FIIs, ETFs, Fiagros, FI-Infra, FIDCs e outros), com suporte a filtros e campos opcionais para enriquecer UI e análises.

Este endpoint é o ponto de entrada para:

• montar um catálogo de fundos
• oferecer busca por ticker
• descobrir tickers alternativos (ex.: recibos em subscrições)
• carregar logos/ícones e metadados quando necessário

Quando usar

• Montar um catálogo de fundos no app/site (com busca e filtros)
• Alimentar um screener de fundos por tipo/segmento
• Popular componentes de UI (ex.: logo/ícone) quando necessário
• Resolver identificadores: symbol (base), ticker (negociação principal) e other_tickers (variações)

Parâmetros

Parâmetro	Local	Descrição	Obrigatório
show_logo	Query	Boolean. Se true, retorna logos e ícones do fundo quando disponíveis.	Opcional
type	Query	Filtra por tipo de fundo (ver lista abaixo).	Opcional

Boas práticas

• Para listas grandes, comece sem enriquecimentos (show_logo=false) e carregue campos adicionais somente quando precisar (ex.: ao abrir o detalhe).
• Use type para reduzir payload (ex.: somente FII).
• Para busca por ticker digitado pelo usuário, normalize e compare contra ticker e other_tickers.

Identificadores e tickers (como interpretar)

• symbol: identificador base do ativo (normalmente o “raiz” do ticker), útil para padronização e para assets como logo/ícone.
• ticker: ticker principal de negociação (ex.: HGLG11, BOVA11).
• other_tickers: tickers alternativos/temporários relacionados ao fundo (por exemplo, variações em eventos de subscrição, recibos e instrumentos negociáveis durante janelas específicas).

Padrão 11 e variações

Em fundos listados (especialmente FIIs e muitos Fiagros), o ticker de negociação costuma terminar em 11.
Em períodos de eventos corporativos (ex.: subscrição), podem existir tickers temporários (ex.: sufixos adicionais) que aparecem em other_tickers.

Tipos de Fundos Listados

Os valores abaixo podem ser usados no filtro type:

• FIAGRO-FIDC — Fiagro de Direitos Creditórios
• FI-INFRA — Fundo de Investimentos em Infraestrutura
• FIP — Fundo de Investimentos em Participações
• ETF-CRIPTO — ETF de Criptomoedas
• FII — Fundo de Investimentos Imobiliários
• ETF-FII — ETF de Fundos de Investimentos Imobiliários
• ETF — Exchange Traded Fund (Fundo Negociado em Bolsa)
• SETORIAL — Fundos Setoriais
• FIAGRO-FII — Fundo de Investimento Imobiliário no Agronegócio
• FIDC — Fundo de Investimentos em Direitos Creditórios
• ETF-RF — ETF de Renda Fixa
• ETF-INT-RF — ETF Internacional de Renda Fixa
• FIAGRO — Fundo de Investimentos no Agronegócio

Campos mais usados no data[]

Campo	Descrição
symbol	Identificador base do ativo (raiz)
ticker	Ticker principal de negociação
other_tickers	Tickers alternativos/temporários relacionados
type	Tipo do fundo (ex.: FII, ETF)
name	Nome completo (razão)
trading_name	Nome de negociação
company_id	Identificador (quando aplicável)
logo / icon	Assets para UI (quando show_logo=true)

Exemplo de Resposta

[
    {
        "symbol": "5PRE",
        "name": "IT NOW TEVA ITBR PRÉ 5 ANOS FUNDO DE ÍNDICE RESPONSABILIDADE LIMITADA",
        "trading_name": "IT NOW PRÉ 5",
        "company_id": "64538158000100",
        "ticker": "5PRE11",
        "type": "ETF-RF",
        "logo": {
            "svg": "https://sa-east-1-public-cdn.partnr.ai/logos/5PRE.svg",
            "png_1024": "https://sa-east-1-public-cdn.partnr.ai/logos/5PRE_1024.png",
            "png_512": "https://sa-east-1-public-cdn.partnr.ai/logos/5PRE_512.png",
            "png_256": "https://sa-east-1-public-cdn.partnr.ai/logos/5PRE_256.png",
            "png_128": "https://sa-east-1-public-cdn.partnr.ai/logos/5PRE_128.png",
            "png_64": "https://sa-east-1-public-cdn.partnr.ai/logos/5PRE_64.png"
        },
        "icon": {
            "svg": "https://sa-east-1-public-cdn.partnr.ai/icons/5PRE.svg",
            "png_1024": "https://sa-east-1-public-cdn.partnr.ai/icons/5PRE_1024.png",
            "png_512": "https://sa-east-1-public-cdn.partnr.ai/icons/5PRE_512.png",
            "png_256": "https://sa-east-1-public-cdn.partnr.ai/icons/5PRE_256.png",
            "png_128": "https://sa-east-1-public-cdn.partnr.ai/icons/5PRE_128.png",
            "png_64": "https://sa-east-1-public-cdn.partnr.ai/icons/5PRE_64.png"
        }
    },
    {
        "type": "FIAGRO",
        "symbol": "AAGR",
        "name": "ASSET BANK AGRONEGÓCIOS FIAGRO - DIREITOS CREDITÓRIOS - RESPONSABILIDADE LIMITADA",
        "trading_name": "FIAGRO AAGR",
        "company_id": "52670402000105",
        "ticker": "AAGR11",
        "logo": {
            "svg": "https://sa-east-1-public-cdn.partnr.ai/logos/AAGR.svg",
            "png_1024": "https://sa-east-1-public-cdn.partnr.ai/logos/AAGR_1024.png",
            "png_512": "https://sa-east-1-public-cdn.partnr.ai/logos/AAGR_512.png",
            "png_256": "https://sa-east-1-public-cdn.partnr.ai/logos/AAGR_256.png",
            "png_128": "https://sa-east-1-public-cdn.partnr.ai/logos/AAGR_128.png",
            "png_64": "https://sa-east-1-public-cdn.partnr.ai/logos/AAGR_64.png"
        },
        "icon": {
            "svg": "https://sa-east-1-public-cdn.partnr.ai/icons/AAGR.svg",
            "png_1024": "https://sa-east-1-public-cdn.partnr.ai/icons/AAGR_1024.png",
            "png_512": "https://sa-east-1-public-cdn.partnr.ai/icons/AAGR_512.png",
            "png_256": "https://sa-east-1-public-cdn.partnr.ai/icons/AAGR_256.png",
            "png_128": "https://sa-east-1-public-cdn.partnr.ai/icons/AAGR_128.png",
            "png_64": "https://sa-east-1-public-cdn.partnr.ai/icons/AAGR_64.png"
        }
    },
    {
        "type": "FIAGRO",
        "symbol": "AAZQ",
        "name": "AZ QUEST SOLE FUNDO DE INVESTIMENTO NAS CADEIAS PRODUTIVAS DO AGRONEGÓCIO - FIAGRO - IMOBILIÁRIO",
        "trading_name": "FIAGRO AAZQ",
        "company_id": "44625826000111",
        "ticker": "AAZQ11",
        "logo": {
            "svg": "https://sa-east-1-public-cdn.partnr.ai/logos/AAZQ.svg",
            "png_1024": "https://sa-east-1-public-cdn.partnr.ai/logos/AAZQ_1024.png",
            "png_512": "https://sa-east-1-public-cdn.partnr.ai/logos/AAZQ_512.png",
            "png_256": "https://sa-east-1-public-cdn.partnr.ai/logos/AAZQ_256.png",
            "png_128": "https://sa-east-1-public-cdn.partnr.ai/logos/AAZQ_128.png",
            "png_64": "https://sa-east-1-public-cdn.partnr.ai/logos/AAZQ_64.png"
        },
        "icon": {
            "svg": "https://sa-east-1-public-cdn.partnr.ai/icons/AAZQ.svg",
            "png_1024": "https://sa-east-1-public-cdn.partnr.ai/icons/AAZQ_1024.png",
            "png_512": "https://sa-east-1-public-cdn.partnr.ai/icons/AAZQ_512.png",
            "png_256": "https://sa-east-1-public-cdn.partnr.ai/icons/AAZQ_256.png",
            "png_128": "https://sa-east-1-public-cdn.partnr.ai/icons/AAZQ_128.png",
            "png_64": "https://sa-east-1-public-cdn.partnr.ai/icons/AAZQ_64.png"
        }
    },
    {
        "type": "FII",
        "symbol": "ABCP",
        "name": "GRAND PLAZA SHOPPING FUNDO DE INVESTIMENTO IMOBILIÁRIO - RESPONSABILIDADE LIMITADA",
        "trading_name": "FII ABC IMOB",
        "company_id": "01201140000190",
        "ticker": "ABCP11",
        "logo": {
            "svg": "https://sa-east-1-public-cdn.partnr.ai/logos/ABCP.svg",
            "png_1024": "https://sa-east-1-public-cdn.partnr.ai/logos/ABCP_1024.png",
            "png_512": "https://sa-east-1-public-cdn.partnr.ai/logos/ABCP_512.png",
            "png_256": "https://sa-east-1-public-cdn.partnr.ai/logos/ABCP_256.png",
            "png_128": "https://sa-east-1-public-cdn.partnr.ai/logos/ABCP_128.png",
            "png_64": "https://sa-east-1-public-cdn.partnr.ai/logos/ABCP_64.png"
        },
        "icon": {
            "svg": "https://sa-east-1-public-cdn.partnr.ai/icons/ABCP.svg",
            "png_1024": "https://sa-east-1-public-cdn.partnr.ai/icons/ABCP_1024.png",
            "png_512": "https://sa-east-1-public-cdn.partnr.ai/icons/ABCP_512.png",
            "png_256": "https://sa-east-1-public-cdn.partnr.ai/icons/ABCP_256.png",
            "png_128": "https://sa-east-1-public-cdn.partnr.ai/icons/ABCP_128.png",
            "png_64": "https://sa-east-1-public-cdn.partnr.ai/icons/ABCP_64.png"
        }
    }
]