Atlas Finance API

Endpoints para dados financeiros e integrações MCP.

A API Atlas dá acesso programático a dados financeiros do mercado brasileiro — ativos, indicadores e séries históricas — em tempo real, via REST ou MCP.

URL basehttps://assets.atlasfin.com.br/

acoes

GET/acoes/list

Listar Acoes

Listar ações, opcionalmente filtradas por ticker ou nome de empresa.

Autenticação: Bearer token

Parâmetros

queryquery

string

Filtro opcional por ticker ou nome da empresa

limitquery

integer

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/acoes/list?query=string&limit=1000000' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "type": "string",
    "identifier": "string",
    "name": "string",
    "tp_fundo": "string",
    "short_name": "string"
  }
]

GET/acoes/indicadores

Listar Indicadores Acoes

Listar indicadores disponíveis para Ações.

Autenticação: Bearer token

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/acoes/indicadores' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "id": "string",
    "name": "string",
    "nome": "string",
    "description": "string",
    "category": "string"
  }
]

GET/acoes/indicadores/calcular

Calcular Indicadores Acao

Calcular indicadores específicos para uma Ação em uma data.

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker da ação

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m, proventos_1y, dividendyield_1y

reference_datequery

stringobrigatório

Data para calcular os indicadores

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/acoes/indicadores/calcular?ticker=string&indicators=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string"
  }
]

GET/acoes/indicadores/historico

Calcular Indicadores Historico Acoes

Calcular indicadores para múltiplas Ações em um intervalo de datas.

Autenticação: Bearer token

Parâmetros

start_datequery

stringobrigatório

Data inicial

end_datequery

stringobrigatório

Data final

periodicityquery

string

Periodicidade: daily, weekly, monthly, yearly

Valores aceitos

dailyweeklymonthlyyearly

tickersquery

string[]obrigatório

Lista de tickers das ações

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, proventos_1y

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/acoes/indicadores/historico?start_date=2026-01-01&end_date=2026-01-01&periodicity=daily&tickers=string&indicators=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string",
    "asset": {
      "asset_type": "fund",
      "asset_id": "string",
      "name": "string",
      "short_name": "string"
    }
  }
]

GET/acoes/historico

Serie Historica Acao

Histórico de Ação (1 identificador)

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker da ação

start_datequery

stringobrigatório

end_datequery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/acoes/historico?ticker=string&start_date=2026-01-01&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "patrimonio_liquido": 0
  }
]

GET/acoes/retorno-percentual

Retorno Percentual Acao

Retorno % de Ação (1 identificador)

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker da ação

start_datequery

string

end_datequery

string

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/acoes/retorno-percentual?ticker=string&start_date=2023-09-18&end_date=2026-01-01&direction=asc&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0
  }
]

GET/acoes/retorno-acumulado

Retorno Acumulado Acao

Retorno acumulado de Ação (1 identificador)

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker da ação

start_datequery

string

end_datequery

string

initial_valuequery

number

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/acoes/retorno-acumulado?ticker=string&start_date=2023-09-18&end_date=2026-01-01&initial_value=1&direction=asc&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0,
    "accumulated_return": 0
  }
]

ativos

GET/assets/assets

Listar Ativos

Lista todos os ativos.

Autenticação: Bearer token

Parâmetros

originquery

string[]obrigatório

Origem dos ativos

Valores aceitos

Fundos CVMIndicadores IPEAIndicadores AnbimaIndicadores BACEN

queryquery

string

Termo de busca para filtrar ativos

pagequery

integer

Número da página

page_sizequery

integer

Número de ativos por página

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/assets?origin=Fundos%20CVM&query=string&page=1&page_size=1000000' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "data": [
    {
      "type": "string",
      "identifier": "string",
      "name": "string",
      "tp_fundo": "string",
      "short_name": "string"
    }
  ],
  "total_rows": 0,
  "last_page": 0,
  "current_page": 0
}

GET/assets/contagem-de-ativos

Asset Count By Type

Retorna a quantidade de ativos únicos agrupados por asset_type.

Autenticação: Bearer token

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/contagem-de-ativos' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "counts": {
    "key": 0
  },
  "total": 0
}

GET/assets/search

Buscar Ativos

Busca ativos em todos os tipos suportados (fundos, benchmarks, etc.). Retorna uma lista unificada de ativos com formato consistente.

Autenticação: Bearer token

Parâmetros

queryquery

string

Termo de busca para filtrar ativos

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/search?query=Teste' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "type": "string",
    "identifier": "string",
    "name": "string",
    "tp_fundo": "string",
    "short_name": "string"
  }
]

GET/assets/asset

Ativo

Obtém informações de metadados para múltiplos IDs de ativos.

Autenticação: Bearer token

Parâmetros

asset_idsquery

string[]obrigatório

Lista de IDs de ativos

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/asset?asset_ids=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "key": {
    "name": "string",
    "type": "string",
    "short_name": "string"
  }
}

GET/assets/historical-series

Serie Historica

Obtém a série histórica para um ativo específico (fundo ou benchmark) com filtro opcional de intervalo de datas.

Autenticação: Bearer token

Parâmetros

asset_idquery

stringobrigatório

start_datequery

string

end_datequery

string

directionquery

string

Valores aceitos

ascdesc

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/historical-series?asset_id=string&start_date=2023-09-18&end_date=2026-01-01&direction=asc' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "patrimonio_liquido": 0
  }
]

GET/assets/price

Preco Ativo

Obtém o preço não ajustado/valor nativo para um ativo específico em uma data exata.

Autenticação: Bearer token

Parâmetros

asset_idquery

stringobrigatório

reference_datequery

stringobrigatório

marcacaoquery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/price?asset_id=string&reference_date=2026-01-01&marcacao=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "asset_id": "string",
  "date": "2026-01-01",
  "price": 0,
  "asset_type": "string",
  "source": "string"
}

GET/assets/percentage-return

Retorno Percentual

Calcula o retorno percentual para um ativo específico (fundo ou benchmark). ((hoje / ontem) - 1) * 100 [valor]

Autenticação: Bearer token

Parâmetros

asset_idquery

stringobrigatório

start_datequery

string

end_datequery

string

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/percentage-return?asset_id=string&start_date=2023-09-18&end_date=2026-01-01&direction=asc&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0
  }
]

GET/assets/accumulated-return

Retorno Acumulado

Calcula o retorno acumulado para um ativo específico (fundo ou benchmark). O valor inicial em start_date é o initial_value especificado e cada valor subsequente é retorno_acumulado_anterior * (1 + retorno_percentual)

Autenticação: Bearer token

Parâmetros

asset_idquery

stringobrigatório

start_datequery

string

end_datequery

string

initial_valuequery

number

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

from_accumulatedquery

boolean

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/accumulated-return?asset_id=string&start_date=2023-09-18&end_date=2026-01-01&initial_value=1&direction=asc&periodicity=daily&from_accumulated=false' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0,
    "accumulated_return": 0
  }
]

GET/assets/historical-interval-date

Intervalo Serie Historica

Obtém as datas do intervalo de dados históricos (datas mín/máx) para uma lista de ativos.

Autenticação: Bearer token

Parâmetros

sourcequery

stringobrigatório

asset_idsquery

string[]obrigatório

Lista de IDs de ativos (CNPJs para fundos ou identificadores de benchmark)

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/historical-interval-date?source=daily_info&asset_ids=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "key": {
    "min_dt_comptc": "2026-01-01",
    "max_dt_comptc": "2026-01-01"
  }
}

GET/assets/max-drawdown

Drawdown Maximo

Obtém o max drawdown para múltiplos ativos (fundos ou benchmarks).

Autenticação: Bearer token

Parâmetros

asset_idsquery

string[]obrigatório

start_datequery

stringobrigatório

end_datequery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/max-drawdown?asset_ids=string&start_date=2026-01-01&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "assets": [
    {
      "asset_id": "string",
      "min": 0,
      "name": "string",
      "data": [
        {
          "date": "2026-01-01",
          "value": 0
        }
      ],
      "short_name": "string"
    }
  ]
}

GET/assets/returns-histogram

Histograma Retornos

Obtém o histograma de retornos para um ativo específico (fundo ou benchmark).

Autenticação: Bearer token

Parâmetros

asset_idquery

stringobrigatório

start_datequery

stringobrigatório

end_datequery

string

bin_widthquery

number

Largura do bin para o histograma (padrão: 0.15)

periodicityquery

string

Periodicidade dos retornos (daily, monthly, yearly)

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/returns-histogram?asset_id=string&start_date=2026-01-01&end_date=2026-01-01&bin_width=0.15&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "data": [
    [
      0
    ]
  ],
  "categories": [
    0
  ],
  "total": 0,
  "normal_fit": [
    [
      0
    ]
  ],
  "fit_percent": 0,
  "total_days": 0,
  "positive_days": 0,
  "negative_days": 0,
  "max_return": 0,
  "min_return": 0,
  "mean_return": 0,
  "histogram_center": 0
}

GET/assets/correlation

Correlacao

Obtém a correlação e covariância para múltiplos ativos. Retorna matrizes de correlação e covariância entre os ativos fornecidos com base em seus retornos percentuais diários sobre o período especificado. Os valores de correlação variam de -1 (correlação negativa perfeita) a 1 (correlação positiva perfeita). Os valores de covariância representam a variabilidade conjunta dos retornos dos ativos. O formato dos dados é otimizado para bibliotecas de visualização de mapa de calor no frontend.

Autenticação: Bearer token

Parâmetros

asset_idsquery

string[]obrigatório

Lista de IDs de ativos para análise de correlação

start_datequery

stringobrigatório

Data de início para o período de análise

end_datequery

string

Data de fim para o período de análise

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/correlation?asset_ids=string&start_date=2026-01-01&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "data": [
    [
      0
    ]
  ],
  "assets": [
    "string"
  ],
  "correlation_matrix": [
    [
      0
    ]
  ],
  "covariance_matrix": [
    [
      0
    ]
  ],
  "short_names": [
    "string"
  ]
}

GET/assets/beta

Beta

Obtém beta, correlação e alfa para múltiplos ativos em relação a um benchmark. Retorna o beta calculado usando correlação e volatilidade, além do alfa da regressão. O beta representa a sensibilidade do ativo aos movimentos do mercado em relação ao benchmark.

Autenticação: Bearer token

Parâmetros

start_datequery

stringobrigatório

end_datequery

string

benchmarkquery

string

asset_idsquery

string[]obrigatório

Lista de IDs de ativos

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/beta?start_date=2026-01-01&end_date=2026-01-01&benchmark=IBOV&asset_ids=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "returns": [
    {
      "date": "2026-01-01",
      "percentage_return": 0,
      "identifier": "string"
    }
  ],
  "metrics": [
    {
      "identifier": "string",
      "beta": 0,
      "name": "string",
      "alpha": 0,
      "correlation": 0
    }
  ],
  "returns_benchmark": [
    {
      "date": "2026-01-01",
      "percentage_return": 0,
      "identifier": "string"
    }
  ]
}

GET/assets/proventos/{asset_id}

Proventos

Obtém proventos de lâmina renda fixa para um Certificado Recebível.

Autenticação: Bearer token

Parâmetros

asset_idpath

stringobrigatório

start_datequery

string

end_datequery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/proventos/string?start_date=2023-09-18&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "empresa": "string",
    "isin": "string",
    "codigo_negociacao": "string",
    "especificacao": "string",
    "tipo_provento": "string",
    "data_aprovacao": "2026-01-01",
    "valor_provento": 0,
    "data_pagamento": "2026-01-01",
    "data_ex": "2026-01-01",
    "data_com": "2026-01-01",
    "exercicio": 0,
    "inicio_correcao": "2026-01-01",
    "fim_correcao": "2026-01-01"
  }
]

GET/assets/debenture/{asset_id}/proventos

Debenture Proventos

Obtém proventos de lâmina renda fixa para uma Debênture.

Autenticação: Bearer token

Parâmetros

asset_idpath

stringobrigatório

start_datequery

string

end_datequery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/debenture/string/proventos?start_date=2023-09-18&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "data_do_pu": "2026-01-01",
    "ativo": "string",
    "valor_nominal": 0,
    "juros": 0,
    "premio": 0,
    "preco_unitario": 0,
    "criterio_de_calculo": "string",
    "sit": "string"
  }
]

POST/assets/markowitz

Markowitz

Calcula a fronteira eficiente de Markowitz e a carteira otimizada para uma lista de ativos. Utiliza retornos diários alinhados durante o período fornecido para estimar retornos médios e covariância, executando otimização média-variância com restrições opcionais: - **Minimizar volatilidade (GMV)**: carteira de mínima variância global - **Maximizar Sharpe**: maximizar índice de Sharpe (use rf_aa_pct para a taxa livre de risco) - **Risco-meta**: maximizar retorno sujeito a volatilidade <= target_vol_aa_pct Bounds (min_pct, max_pct por ativo) são opcionais; padrão 0% e 100%.

Autenticação: Bearer token

REQUISIÇÃOcURL / JSON

curl --request POST \
  --url 'https://assets.atlasfin.com.br/assets/markowitz' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "asset_ids": [
    "string"
  ],
  "start_date": "2026-01-01",
  "end_date": "2026-01-01",
  "periodos_ano": 252,
  "n_front": 140,
  "n_mc": 3000,
  "opt_mode": "Minimizar volatilidade (GMV)",
  "rf_aa_pct": 0,
  "target_vol_aa_pct": 0,
  "bounds": [
    {
      "asset_id": "string",
      "min_pct": 0,
      "max_pct": 100
    }
  ],
  "seed": 7
}'

RESPOSTA

Successful Response application/json

{
  "ret_min_aa": 0,
  "ret_max_aa": 0,
  "gmv": {
    "ret_aa": 0,
    "vol_aa": 0,
    "weights": {
      "key": 0
    }
  },
  "full_frontier": [
    {
      "vol_aa": 0,
      "ret_aa": 0,
      "weights": {
        "key": 0
      }
    }
  ],
  "efficient_frontier": [
    {
      "vol_aa": 0,
      "ret_aa": 0,
      "weights": {
        "key": 0
      }
    }
  ],
  "monte_carlo": [
    {
      "vol_aa": 0,
      "ret_aa": 0
    }
  ],
  "optimized": {
    "tag": "string",
    "ret_aa": 0,
    "vol_aa": 0,
    "weights": {
      "key": 0
    },
    "sharpe_aa": 0
  },
  "asset_ids": [
    "string"
  ]
}

GET/assets/monte-carlo

Monte Carlo

Executa a simulação Monte Carlo para um ativo específico ou carteira. Utiliza retornos históricos para estimar retorno esperado (mu) e volatilidade (sigma), simulando então a evolução da carteira com aportes mensais sobre o horizonte de investimento especificado. Para carteiras, utiliza simulação Monte Carlo ponderada com correlação entre os ativos. Retorna estatísticas da trajetória, distribuição do valor final e caminhos de amostra para visualização.

Autenticação: Bearer token

Parâmetros

asset_idquery

stringobrigatório

start_datequery

string

Data de início dos dados históricos para estimar parâmetros

end_datequery

string

Data de fim dos dados históricos (padrão: hoje)

n_simulationsquery

integer

Número de simulações de Monte Carlo

n_periodsquery

integer

Horizonte de investimento em meses

periodicityquery

string

Periodicidade dos retornos (daily, monthly, yearly)

Valores aceitos

dailyweeklymonthlyyearly

initial_capitalquery

number

Capital inicial do investimento

monthly_contributionquery

number

Valor do aporte mensal

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/assets/monte-carlo?asset_id=string&start_date=2023-09-18&end_date=2026-01-01&n_simulations=10000&n_periods=120&periodicity=monthly&initial_capital=10000&monthly_contribution=1000' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "n_simulations": 0,
  "n_periods": 0,
  "initial_capital": 0,
  "monthly_contribution": 0,
  "mu_annual": 0,
  "sigma_annual": 0,
  "historical_days": 0,
  "final_statistics": {
    "mean": 0,
    "median": 0,
    "std": 0,
    "p5": 0,
    "p10": 0,
    "p25": 0,
    "p75": 0,
    "p90": 0,
    "p95": 0,
    "min": 0,
    "max": 0
  },
  "trajectory": [
    {
      "period": 0,
      "mean": 0,
      "p5": 0,
      "p25": 0,
      "p50": 0,
      "p75": 0,
      "p95": 0
    }
  ],
  "sample_trajectories": [
    [
      0
    ]
  ]
}

benchmarks

GET/benchmarks/list

Listar Benchmarks

Listar Benchmarks (mostrar todos)

Autenticação: Bearer token

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/benchmarks/list' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "name": "string",
    "id_benchmark": "string",
    "min_date": "2026-01-01",
    "max_date": "2026-01-01"
  }
]

GET/benchmarks/indicadores

Listar Indicadores Benchmarks

Listar indicadores disponíveis para Benchmarks.

Autenticação: Bearer token

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/benchmarks/indicadores' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "id": "string",
    "name": "string",
    "nome": "string",
    "description": "string",
    "category": "string"
  }
]

GET/benchmarks/indicadores/calcular

Calcular Indicadores Benchmark

Calcular indicadores específicos para um benchmark em uma data.

Autenticação: Bearer token

Parâmetros

nomequery

stringobrigatório

Nome do benchmark

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m, benchmark_value, primeira-data, ultima-data

reference_datequery

stringobrigatório

Data para calcular os indicadores

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/benchmarks/indicadores/calcular?nome=string&indicators=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string"
  }
]

GET/benchmarks/indicadores/historico

Calcular Indicadores Historico Benchmarks

Calcular indicadores para múltiplos benchmarks em um intervalo de datas.

Autenticação: Bearer token

Parâmetros

start_datequery

stringobrigatório

Data inicial

end_datequery

stringobrigatório

Data final

periodicityquery

string

Periodicidade: daily, weekly, monthly, yearly

Valores aceitos

dailyweeklymonthlyyearly

nomesquery

string[]obrigatório

Lista de nomes de benchmarks

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, benchmark_value

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/benchmarks/indicadores/historico?start_date=2026-01-01&end_date=2026-01-01&periodicity=daily&nomes=string&indicators=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string",
    "asset": {
      "asset_type": "fund",
      "asset_id": "string",
      "name": "string",
      "short_name": "string"
    }
  }
]

GET/benchmarks/historico

Serie Historica Benchmark

Histórico de Benchmark (1 identificador)

Autenticação: Bearer token

Parâmetros

nomequery

stringobrigatório

start_datequery

stringobrigatório

end_datequery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/benchmarks/historico?nome=string&start_date=2026-01-01&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "name": "string",
    "value": 0,
    "date": "2026-01-01",
    "description": "string"
  }
]

GET/benchmarks/retorno-percentual

Retorno Percentual Benchmark

Retorno % de benchmark (1 identificador)

Autenticação: Bearer token

Parâmetros

nomequery

stringobrigatório

start_datequery

stringobrigatório

end_datequery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/benchmarks/retorno-percentual?nome=string&start_date=2026-01-01&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "percentage_return": 0,
    "data": "2026-01-01",
    "valor": 0
  }
]

GET/benchmarks/retorno-acumulado

Retorno Acumulado Benchmark

Retorno acumulado de benchmark (1 identificador)

Autenticação: Bearer token

Parâmetros

nomequery

stringobrigatório

start_datequery

stringobrigatório

end_datequery

stringobrigatório

initial_valuequery

number

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/benchmarks/retorno-acumulado?nome=string&start_date=2026-01-01&end_date=2026-01-01&initial_value=1' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "accumulated_return": 0,
    "data": "2026-01-01",
    "valor": 0,
    "percentage_return": 0
  }
]

criptomoedas

GET/criptomoedas/list

Listar Criptomoedas

Listar criptomoedas, opcionalmente filtradas por ticker, símbolo ou nome.

Autenticação: Bearer token

Parâmetros

queryquery

string

Filtro opcional por ticker, símbolo ou nome da criptomoeda

limitquery

integer

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/criptomoedas/list?query=string&limit=1000000' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "type": "string",
    "identifier": "string",
    "name": "string",
    "tp_fundo": "string",
    "short_name": "string"
  }
]

GET/criptomoedas/indicadores

Listar Indicadores Criptomoedas

Listar indicadores disponíveis para Criptomoedas.

Autenticação: Bearer token

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/criptomoedas/indicadores' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "id": "string",
    "name": "string",
    "nome": "string",
    "description": "string",
    "category": "string"
  }
]

GET/criptomoedas/indicadores/calcular

Calcular Indicadores Criptomoeda

Calcular indicadores específicos para uma Criptomoeda em uma data.

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker da criptomoeda (ex: BTC-USD)

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m

reference_datequery

stringobrigatório

Data para calcular os indicadores

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/criptomoedas/indicadores/calcular?ticker=string&indicators=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string"
  }
]

GET/criptomoedas/indicadores/historico

Calcular Indicadores Historico Criptomoedas

Calcular indicadores para múltiplas Criptomoedas em um intervalo de datas.

Autenticação: Bearer token

Parâmetros

start_datequery

stringobrigatório

Data inicial

end_datequery

stringobrigatório

Data final

periodicityquery

string

Periodicidade: daily, weekly, monthly, yearly

Valores aceitos

dailyweeklymonthlyyearly

tickersquery

string[]obrigatório

Lista de tickers das criptomoedas (ex: BTC-USD)

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/criptomoedas/indicadores/historico?start_date=2026-01-01&end_date=2026-01-01&periodicity=daily&tickers=string&indicators=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string",
    "asset": {
      "asset_type": "fund",
      "asset_id": "string",
      "name": "string",
      "short_name": "string"
    }
  }
]

GET/criptomoedas/historico

Serie Historica Criptomoeda

Histórico de Criptomoeda (1 identificador)

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker da criptomoeda (ex: BTC-USD)

start_datequery

stringobrigatório

end_datequery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/criptomoedas/historico?ticker=string&start_date=2026-01-01&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "patrimonio_liquido": 0
  }
]

GET/criptomoedas/retorno-percentual

Retorno Percentual Criptomoeda

Retorno % de Criptomoeda (1 identificador)

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker da criptomoeda (ex: BTC-USD)

start_datequery

string

end_datequery

string

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/criptomoedas/retorno-percentual?ticker=string&start_date=2023-09-18&end_date=2026-01-01&direction=asc&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0
  }
]

GET/criptomoedas/retorno-acumulado

Retorno Acumulado Criptomoeda

Retorno acumulado de Criptomoeda (1 identificador)

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker da criptomoeda (ex: BTC-USD)

start_datequery

string

end_datequery

string

initial_valuequery

number

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/criptomoedas/retorno-acumulado?ticker=string&start_date=2023-09-18&end_date=2026-01-01&initial_value=1&direction=asc&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0,
    "accumulated_return": 0
  }
]

certificados-recebiveis

GET/certificados-recebiveis/

Buscar Certificados Recebiveis

Listar certificados, opcionalmente filtrados por código, emissor, devedor ou tipo.

Autenticação: Bearer token

Parâmetros

queryquery

string

Filtro opcional por código, emissor, devedor ou tipo

limitquery

integer

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/certificados-recebiveis/?query=string&limit=1000000' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "codigo": "string",
    "emissor": "string",
    "devedor": "string",
    "tipo": "string",
    "tipo_remuneracao": "string"
  }
]

GET/certificados-recebiveis/indicadores

Listar Indicadores Certificados Recebiveis

Listar indicadores disponíveis para Certificados Recebíveis.

Autenticação: Bearer token

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/certificados-recebiveis/indicadores' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "id": "string",
    "name": "string",
    "nome": "string",
    "description": "string",
    "category": "string"
  }
]

GET/certificados-recebiveis/indicadores/calcular

Calcular Indicadores Certificado Recebivel

Calcular indicadores específicos para um Certificado Recebível em uma data.

Autenticação: Bearer token

Parâmetros

codigoquery

stringobrigatório

Código do Certificado Recebível

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m

reference_datequery

stringobrigatório

Data para calcular os indicadores

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/certificados-recebiveis/indicadores/calcular?codigo=string&indicators=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string"
  }
]

GET/certificados-recebiveis/indicadores/historico

Calcular Indicadores Historico Certificados Recebiveis

Calcular indicadores para múltiplos Certificados Recebíveis em um intervalo de datas.

Autenticação: Bearer token

Parâmetros

start_datequery

stringobrigatório

Data inicial

end_datequery

stringobrigatório

Data final

periodicityquery

string

Periodicidade: daily, weekly, monthly, yearly

Valores aceitos

dailyweeklymonthlyyearly

codigosquery

string[]obrigatório

Lista de códigos dos Certificados Recebíveis

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/certificados-recebiveis/indicadores/historico?start_date=2026-01-01&end_date=2026-01-01&periodicity=daily&codigos=string&indicators=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string",
    "asset": {
      "asset_type": "fund",
      "asset_id": "string",
      "name": "string",
      "short_name": "string"
    }
  }
]

GET/certificados-recebiveis/cadastral

Certificados Recebiveis Cadastral

Obter dados cadastrais de Certificados Recebíveis para múltiplos identificadores (até 5) e apenas 1 dia.

Autenticação: Bearer token

Parâmetros

codigosquery

string[]obrigatório

Lista de identificadores (até 5)

reference_datequery

stringobrigatório

Data de referência para os dados cadastrais (apenas 1 dia)

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/certificados-recebiveis/cadastral?codigos=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "codigo": "string",
    "emissor": "string",
    "devedor": "string",
    "tipo": "string",
    "tipo_remuneracao": "string",
    "data_referencia": "2026-01-01",
    "taxa_correcao": 0,
    "serie": "string",
    "emissao": "string",
    "data_vencimento": "2026-01-01",
    "taxa_compra": 0,
    "taxa_venda": 0,
    "taxa_indicativa": 0,
    "pu_indicativo": 0,
    "pu_par": 0,
    "pu_compra": 0,
    "desvio_padrao": 0,
    "duration": 0,
    "perc_pu_par": 0,
    "perc_vne": 0,
    "perc_reune": "string",
    "referencia_ntnb": "2026-01-01"
  }
]

GET/certificados-recebiveis/historico-precos

Preco Historico Certificados Recebiveis

Histórico de preços de Certificados Recebíveis (múltiplos identificadores (até 5) e múltiplos dias, apenas dados de preços).

Autenticação: Bearer token

Parâmetros

codigosquery

string[]obrigatório

Lista de identificadores (até 5)

start_datequery

stringobrigatório

end_datequery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/certificados-recebiveis/historico-precos?codigos=string&start_date=2026-01-01&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "codigo": [
    {
      "date": "2026-01-02",
      "pu_compra": null,
      "pu_indicativo": 1232.398798,
      "pu_par": null,
      "taxa_compra": 11.5504,
      "taxa_indicativa": 11.3116,
      "taxa_venda": null
    }
  ]
}

GET/certificados-recebiveis/proventos

Certificados Recebiveis Proventos

Proventos de Certificados Recebíveis (múltiplos identificadores (até 5) e até 1 ano de intervalo).

Autenticação: Bearer token

Parâmetros

codigosquery

string[]obrigatório

Lista de identificadores (até 5)

start_datequery

stringobrigatório

end_datequery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/certificados-recebiveis/proventos?codigos=string&start_date=2026-01-01&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "key": [
    {
      "empresa": "string",
      "isin": "string",
      "codigo_negociacao": "string",
      "especificacao": "string",
      "tipo_provento": "string",
      "data_aprovacao": "2026-01-01",
      "valor_provento": 0,
      "data_pagamento": "2026-01-01",
      "data_ex": "2026-01-01",
      "data_com": "2026-01-01",
      "exercicio": 0,
      "inicio_correcao": "2026-01-01",
      "fim_correcao": "2026-01-01"
    }
  ]
}

debentures

GET/debentures/list

Listar Debentures

Listar debêntures, opcionalmente filtradas por código, emissor ou remuneração.

Autenticação: Bearer token

Parâmetros

queryquery

string

Filtro opcional por código, emissor ou tipo de remuneração

limitquery

integer

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/debentures/list?query=string&limit=1000000' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "type": "string",
    "identifier": "string",
    "name": "string",
    "tp_fundo": "string",
    "short_name": "string"
  }
]

GET/debentures/historico

Serie Historica Debenture

Histórico de Debênture (1 identificador)

Autenticação: Bearer token

Parâmetros

codigoquery

stringobrigatório

Código da Debênture

start_datequery

stringobrigatório

end_datequery

stringobrigatório

marcacaoquery

string

Tipo de marcação da série histórica

Valores aceitos

pu_anbimapu_parpu_comprataxa_indicativataxa_comprataxa_venda

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/debentures/historico?codigo=string&start_date=2026-01-01&end_date=2026-01-01&marcacao=pu_anbima' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "patrimonio_liquido": 0
  }
]

GET/debentures/retorno-percentual

Retorno Percentual Debenture

Retorno % de Debênture (1 identificador)

Autenticação: Bearer token

Parâmetros

codigoquery

stringobrigatório

Código da Debênture

start_datequery

string

end_datequery

string

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

marcacaoquery

string

Tipo de marcação usada no retorno percentual

Valores aceitos

pu_anbimapu_parpu_comprataxa_indicativataxa_comprataxa_venda

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/debentures/retorno-percentual?codigo=string&start_date=2023-09-18&end_date=2026-01-01&direction=asc&periodicity=daily&marcacao=pu_anbima' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0
  }
]

GET/debentures/retorno-acumulado

Retorno Acumulado Debenture

Retorno acumulado de Debênture (1 identificador)

Autenticação: Bearer token

Parâmetros

codigoquery

stringobrigatório

Código da Debênture

start_datequery

string

end_datequery

string

initial_valuequery

number

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

marcacaoquery

string

Tipo de marcação usada no retorno acumulado

Valores aceitos

pu_anbimapu_parpu_comprataxa_indicativataxa_comprataxa_venda

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/debentures/retorno-acumulado?codigo=string&start_date=2023-09-18&end_date=2026-01-01&initial_value=1&direction=asc&periodicity=daily&marcacao=pu_anbima' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0,
    "accumulated_return": 0
  }
]

GET/debentures/cadastro

Consultar cadastro da debênture

Autenticação: Bearer token

Parâmetros

asset_idquery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/debentures/cadastro?asset_id=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "asset_id": "string",
  "reference_date": "string",
  "data": {}
}

GET/debentures/taxas

Consultar taxas da debênture

Autenticação: Bearer token

Parâmetros

asset_idquery

stringobrigatório

start_datequery

stringobrigatório

end_datequery

stringobrigatório

limitquery

integer

cursorquery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/debentures/taxas?asset_id=string&start_date=string&end_date=string&limit=2000&cursor=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "asset_id": "string",
  "start_date": "string",
  "end_date": "string",
  "data": [
    {}
  ],
  "count": 0,
  "total_count": 0,
  "has_more": false,
  "next_cursor": "string"
}

GET/debentures/curvas-pu

Consultar preços unitários da debênture

Autenticação: Bearer token

Parâmetros

asset_idquery

stringobrigatório

start_datequery

stringobrigatório

end_datequery

stringobrigatório

limitquery

integer

cursorquery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/debentures/curvas-pu?asset_id=string&start_date=string&end_date=string&limit=2000&cursor=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "asset_id": "string",
  "start_date": "string",
  "end_date": "string",
  "data": [
    {}
  ],
  "count": 0,
  "total_count": 0,
  "has_more": false,
  "next_cursor": "string"
}

fidcs

GET/fidcs/list

Listar Fidcs

Listar FIDCs, opcionalmente filtrados por CNPJ, classe ou código ANBIMA.

Autenticação: Bearer token

Parâmetros

queryquery

string

Filtro opcional por CNPJ, identificador, nome ou código ANBIMA

limitquery

integer

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fidcs/list?query=string&limit=1000000' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "type": "string",
    "identifier": "string",
    "name": "string",
    "tp_fundo": "string",
    "short_name": "string"
  }
]

GET/fidcs/indicadores

Listar Indicadores Fidcs

Listar indicadores disponíveis para FIDCs.

Autenticação: Bearer token

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fidcs/indicadores' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "id": "string",
    "name": "string",
    "nome": "string",
    "description": "string",
    "category": "string"
  }
]

GET/fidcs/indicadores/calcular

Calcular Indicadores Fidc

Calcular indicadores específicos para um FIDC em uma data.

Autenticação: Bearer token

Parâmetros

identificadorquery

stringobrigatório

Identificador do FIDC (CNPJ ou CNPJ_CLASSE_COTA)

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m

reference_datequery

stringobrigatório

Data para calcular os indicadores

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fidcs/indicadores/calcular?identificador=string&indicators=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string"
  }
]

GET/fidcs/indicadores/historico

Calcular Indicadores Historico Fidcs

Calcular indicadores para múltiplos FIDCs em um intervalo de datas.

Autenticação: Bearer token

Parâmetros

start_datequery

stringobrigatório

Data inicial

end_datequery

stringobrigatório

Data final

periodicityquery

string

Periodicidade: daily, weekly, monthly, yearly

Valores aceitos

dailyweeklymonthlyyearly

identificadoresquery

string[]obrigatório

Lista de identificadores dos FIDCs

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fidcs/indicadores/historico?start_date=2026-01-01&end_date=2026-01-01&periodicity=daily&identificadores=string&indicators=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string",
    "asset": {
      "asset_type": "fund",
      "asset_id": "string",
      "name": "string",
      "short_name": "string"
    }
  }
]

GET/fidcs/historico

Serie Historica Fidc

Histórico de FIDC (1 identificador).

Autenticação: Bearer token

Parâmetros

identificadorquery

stringobrigatório

Identificador do FIDC (CNPJ ou CNPJ_CLASSE_COTA)

start_datequery

stringobrigatório

end_datequery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fidcs/historico?identificador=string&start_date=2026-01-01&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "patrimonio_liquido": 0
  }
]

GET/fidcs/retorno-percentual

Retorno Percentual Fidc

Retorno % de FIDC (1 identificador).

Autenticação: Bearer token

Parâmetros

identificadorquery

stringobrigatório

Identificador do FIDC (CNPJ ou CNPJ_CLASSE_COTA)

start_datequery

string

end_datequery

string

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fidcs/retorno-percentual?identificador=string&start_date=2023-09-18&end_date=2026-01-01&direction=asc&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0
  }
]

GET/fidcs/retorno-acumulado

Retorno Acumulado Fidc

Retorno acumulado de FIDC (1 identificador).

Autenticação: Bearer token

Parâmetros

identificadorquery

stringobrigatório

Identificador do FIDC (CNPJ ou CNPJ_CLASSE_COTA)

start_datequery

string

end_datequery

string

initial_valuequery

number

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fidcs/retorno-acumulado?identificador=string&start_date=2023-09-18&end_date=2026-01-01&initial_value=1&direction=asc&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0,
    "accumulated_return": 0
  }
]

fundos

GET/fundos/patrimonio-liquido

Consultar patrimônio líquido do fundo

Autenticação: Bearer token

Parâmetros

cnpjquery

stringobrigatório

start_datequery

stringobrigatório

end_datequery

stringobrigatório

limitquery

integer

cursorquery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fundos/patrimonio-liquido?cnpj=string&start_date=string&end_date=string&limit=2000&cursor=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "cnpj": "string",
  "start_date": "string",
  "end_date": "string",
  "data": [
    {}
  ],
  "count": 0,
  "total_count": 0,
  "has_more": false,
  "next_cursor": "string"
}

GET/fundos/perfil-mensal

Consultar perfil mensal do fundo

Autenticação: Bearer token

Parâmetros

cnpjquery

stringobrigatório

month_yearquery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fundos/perfil-mensal?cnpj=string&month_year=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "cnpj": "string",
  "month_year": "string",
  "data": {}
}

GET/fundos/captacao-resgate

Consultar captações e resgates do fundo

Autenticação: Bearer token

Parâmetros

cnpjquery

stringobrigatório

start_datequery

stringobrigatório

end_datequery

stringobrigatório

limitquery

integer

cursorquery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fundos/captacao-resgate?cnpj=string&start_date=string&end_date=string&limit=2000&cursor=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "cnpj": "string",
  "start_date": "string",
  "end_date": "string",
  "data": [
    {}
  ],
  "count": 0,
  "total_count": 0,
  "has_more": false,
  "next_cursor": "string"
}

GET/fundos/carteira

Consultar carteira do fundo

Autenticação: Bearer token

Parâmetros

cnpjquery

stringobrigatório

month_yearquery

stringobrigatório

limitquery

integer

cursorquery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fundos/carteira?cnpj=string&month_year=string&limit=2000&cursor=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "cnpj": "string",
  "month_year": "string",
  "data": [
    {}
  ],
  "count": 0,
  "total_count": 0,
  "has_more": false,
  "next_cursor": "string"
}

GET/funds/fund-info

Consultar informações do fundo

Consulta as informações cadastrais e os indicadores de um fundo pelo CNPJ.

Autenticação: Bearer token

Parâmetros

cnpjquery

stringobrigatório

CNPJ do fundo no formato XX.XXX.XXX/XXXX-XX

reference_datequery

string

Data de referência para as informações do fundo. Quando não informada, utiliza a data atual.

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/funds/fund-info?cnpj=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Informações do fundo encontradas com sucesso application/json

{
  "id": 0,
  "tp_fundo": "string",
  "denom_social": "string",
  "cnpj_fundo": "string",
  "cnpj_admin": "string",
  "admin": "string",
  "cnpj_auditor": "string",
  "auditor": "string",
  "classe": "string",
  "condom": "string",
  "cnpj_controlador": "string",
  "controlador": "string",
  "cnpj_custodiante": "string",
  "custodiante": "string",
  "diretor": "string",
  "fundo_exclusivo": "string",
  "fundo_cotas": "string",
  "gestor": "string",
  "cpf_cnpj_gestor": "string",
  "pf_pj_gestor": "PF",
  "publico_alvo": "string",
  "rentab_fundo": "string",
  "sit": "string",
  "vl_taxa_perfm": 0,
  "ds_taxa_perfm": "string",
  "taxa_adm": 0,
  "trib_lprazo": "string",
  "retorno_dia": 0,
  "retorno_mes": 0,
  "retorno_ano": 0,
  "retorno_12m": 0,
  "retorno_24m": 0,
  "retorno_36m": 0,
  "min_dt_comptc": "2026-01-01",
  "max_dt_comptc": "2026-01-01",
  "numero_cotistas": 0,
  "vl_patrim_liq": 0,
  "short_name": "string"
}

cias

GET/cias/list

Listar Companhias

Listar companhias abertas com dados ITR disponíveis.

Autenticação: Não requerida

Parâmetros

queryquery

string

Filtro opcional por nome da companhia ou CNPJ

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/cias/list?query=string'

RESPOSTA

Successful Response application/json

[
  {
    "cnpj_cia": "string",
    "denom_cia": "string",
    "cd_cvm": "string",
    "latest_dt_refer": "2026-01-01"
  }
]

GET/cias/info

Companhia Info

Informações cadastrais da companhia (registro mais recente).

Autenticação: Não requerida

Parâmetros

cnpj_ciaquery

stringobrigatório

CNPJ da companhia (com ou sem formatação)

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/cias/info?cnpj_cia=string'

RESPOSTA

Successful Response application/json

{
  "cnpj_cia": "string",
  "dt_refer": "2026-01-01",
  "versao": 0,
  "denom_cia": "string",
  "cd_cvm": "string",
  "categ_doc": "string",
  "id_doc": "string",
  "dt_receb": "2026-01-01",
  "link_doc": "string"
}

GET/cias/bpa

Balanco Patrimonial Ativo

Balanço Patrimonial Ativo hierárquico por empresa.

Autenticação: Não requerida

Parâmetros

cnpj_ciaquery

stringobrigatório

CNPJ da companhia (com ou sem formatação)

dataquery

string

Data de referência (padrão: mais recente)

consolidadoquery

boolean

Se true, retorna demonstração consolidada

ordem_exercquery

string

ÚLTIMO ou PENÚLTIMO (padrão: ÚLTIMO)

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/cias/bpa?cnpj_cia=string&data=2026-01-01&consolidado=true&ordem_exerc=string'

RESPOSTA

Successful Response application/json

{
  "cnpj_cia": "string",
  "dt_refer": "2026-01-01",
  "versao": 0,
  "is_consolidated": false,
  "grupo_dfp": "string",
  "moeda": "string",
  "escala_moeda": "string",
  "ordem_exerc": "string",
  "dt_fim_exerc": "2026-01-01",
  "itens": [
    {
      "cd_conta": "string",
      "ds_conta": "string",
      "vl_conta": 0,
      "nivel": 0,
      "st_conta_fixa": "string",
      "sub_itens": []
    }
  ]
}

GET/cias/bpp

Balanco Patrimonial Passivo

Balanço Patrimonial Passivo e PL hierárquico por empresa.

Autenticação: Não requerida

Parâmetros

cnpj_ciaquery

stringobrigatório

CNPJ da companhia (com ou sem formatação)

dataquery

string

Data de referência (padrão: mais recente)

consolidadoquery

boolean

Se true, retorna demonstração consolidada

ordem_exercquery

string

ÚLTIMO ou PENÚLTIMO (padrão: ÚLTIMO)

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/cias/bpp?cnpj_cia=string&data=2026-01-01&consolidado=true&ordem_exerc=string'

RESPOSTA

Successful Response application/json

{
  "cnpj_cia": "string",
  "dt_refer": "2026-01-01",
  "versao": 0,
  "is_consolidated": false,
  "grupo_dfp": "string",
  "moeda": "string",
  "escala_moeda": "string",
  "ordem_exerc": "string",
  "dt_fim_exerc": "2026-01-01",
  "itens": [
    {
      "cd_conta": "string",
      "ds_conta": "string",
      "vl_conta": 0,
      "nivel": 0,
      "st_conta_fixa": "string",
      "sub_itens": []
    }
  ]
}

GET/cias/dre

Demonstracao Resultado

Demonstração do Resultado hierárquica por empresa.

Autenticação: Não requerida

Parâmetros

cnpj_ciaquery

stringobrigatório

CNPJ da companhia (com ou sem formatação)

dataquery

string

Data de referência (padrão: mais recente)

consolidadoquery

boolean

Se true, retorna demonstração consolidada

ordem_exercquery

string

ÚLTIMO ou PENÚLTIMO (padrão: ÚLTIMO)

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/cias/dre?cnpj_cia=string&data=2026-01-01&consolidado=true&ordem_exerc=string'

RESPOSTA

Successful Response application/json

{
  "cnpj_cia": "string",
  "dt_refer": "2026-01-01",
  "versao": 0,
  "is_consolidated": false,
  "grupo_dfp": "string",
  "moeda": "string",
  "escala_moeda": "string",
  "ordem_exerc": "string",
  "dt_ini_exerc": "2026-01-01",
  "dt_fim_exerc": "2026-01-01",
  "itens": [
    {
      "cd_conta": "string",
      "ds_conta": "string",
      "vl_conta": 0,
      "nivel": 0,
      "st_conta_fixa": "string",
      "sub_itens": []
    }
  ]
}

GET/cias/dfc-mi

Demonstracao Fluxo Caixa

Fluxo de Caixa (Método Indireto) hierárquico por empresa.

Autenticação: Não requerida

Parâmetros

cnpj_ciaquery

stringobrigatório

CNPJ da companhia (com ou sem formatação)

dataquery

string

Data de referência (padrão: mais recente)

consolidadoquery

boolean

Se true, retorna demonstração consolidada

ordem_exercquery

string

ÚLTIMO ou PENÚLTIMO (padrão: ÚLTIMO)

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/cias/dfc-mi?cnpj_cia=string&data=2026-01-01&consolidado=true&ordem_exerc=string'

RESPOSTA

Successful Response application/json

{
  "cnpj_cia": "string",
  "dt_refer": "2026-01-01",
  "versao": 0,
  "is_consolidated": false,
  "grupo_dfp": "string",
  "moeda": "string",
  "escala_moeda": "string",
  "ordem_exerc": "string",
  "dt_ini_exerc": "2026-01-01",
  "dt_fim_exerc": "2026-01-01",
  "itens": [
    {
      "cd_conta": "string",
      "ds_conta": "string",
      "vl_conta": 0,
      "nivel": 0,
      "st_conta_fixa": "string",
      "sub_itens": []
    }
  ]
}

GET/cias/resumo

Resumo Completo

Resumo com todas as demonstrações (BPA, BPP, DRE, DFC_MI) da empresa na mesma data.

Autenticação: Não requerida

Parâmetros

cnpj_ciaquery

stringobrigatório

CNPJ da companhia (com ou sem formatação)

dataquery

string

Data de referência (padrão: mais recente)

consolidadoquery

boolean

Se true, retorna demonstrações consolidadas

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/cias/resumo?cnpj_cia=string&data=2026-01-01&consolidado=true'

RESPOSTA

Successful Response application/json

{
  "cnpj_cia": "string",
  "denom_cia": "string",
  "cd_cvm": "string",
  "latest_dt_refer": "2026-01-01",
  "bpa": {
    "cnpj_cia": "string",
    "dt_refer": "2026-01-01",
    "versao": 0,
    "is_consolidated": false,
    "grupo_dfp": "string",
    "moeda": "string",
    "escala_moeda": "string",
    "ordem_exerc": "string",
    "dt_fim_exerc": "2026-01-01",
    "itens": [
      {
        "cd_conta": "string",
        "ds_conta": "string",
        "nivel": 0,
        "sub_itens": []
      }
    ]
  },
  "bpp": {
    "cnpj_cia": "string",
    "dt_refer": "2026-01-01",
    "versao": 0,
    "is_consolidated": false,
    "grupo_dfp": "string",
    "moeda": "string",
    "escala_moeda": "string",
    "ordem_exerc": "string",
    "dt_fim_exerc": "2026-01-01",
    "itens": [
      {
        "cd_conta": "string",
        "ds_conta": "string",
        "nivel": 0,
        "sub_itens": []
      }
    ]
  },
  "dre": {
    "cnpj_cia": "string",
    "dt_refer": "2026-01-01",
    "versao": 0,
    "is_consolidated": false,
    "grupo_dfp": "string",
    "moeda": "string",
    "escala_moeda": "string",
    "ordem_exerc": "string",
    "dt_ini_exerc": "2026-01-01",
    "dt_fim_exerc": "2026-01-01",
    "itens": [
      {
        "cd_conta": "string",
        "ds_conta": "string",
        "nivel": 0,
        "sub_itens": []
      }
    ]
  },
  "dfc_mi": {
    "cnpj_cia": "string",
    "dt_refer": "2026-01-01",
    "versao": 0,
    "is_consolidated": false,
    "grupo_dfp": "string",
    "moeda": "string",
    "escala_moeda": "string",
    "ordem_exerc": "string",
    "dt_ini_exerc": "2026-01-01",
    "dt_fim_exerc": "2026-01-01",
    "itens": [
      {
        "cd_conta": "string",
        "ds_conta": "string",
        "nivel": 0,
        "sub_itens": []
      }
    ]
  }
}

fiis

GET/fiis/cadastral

Consultar cadastro CVM do FII

Retorna o cadastro CVM mais recente disponível para o ticker.

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker do FII, por exemplo HGLG11

reference_datequery

string

Data limite inclusiva para o cadastro CVM

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fiis/cadastral?ticker=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "ticker": "string",
  "tp_fundo": "string",
  "cnpj_fundo": "string",
  "data_referencia": "2026-01-01",
  "versao": 0,
  "data_entrega": "2026-01-01",
  "nome_fundo": "string",
  "data_funcionamento": "2026-01-01",
  "publico_alvo": "string",
  "codigo_isin": "string",
  "quantidade_cotas_emitidas": "string",
  "fundo_exclusivo": "string",
  "cotistas_vinculo_familiar": "string",
  "mandato": "string",
  "segmento_atuacao": "string",
  "tipo_gestao": "string",
  "prazo_duracao": "string",
  "data_prazo_duracao": "2026-01-01",
  "encerramento_exercicio_social": "string",
  "mercado_negociacao_bolsa": "string",
  "mercado_negociacao_mbo": "string",
  "mercado_negociacao_mb": "string",
  "entidade_administradora_bvmf": "string",
  "entidade_administradora_cetip": "string",
  "nome_administrador": "string",
  "cnpj_administrador": "string",
  "logradouro": "string",
  "numero": "string",
  "complemento": "string",
  "bairro": "string",
  "cidade": "string",
  "estado": "string",
  "cep": "string",
  "telefone1": "string",
  "telefone2": "string",
  "telefone3": "string",
  "site": "string",
  "email": "string"
}

GET/fiis/proventos

Consultar proventos do FII

Retorna uma página de proventos do FII filtrada pela data ex.

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker do FII, por exemplo HGLG11

start_datequery

stringobrigatório

Data ex inicial inclusiva

end_datequery

stringobrigatório

Data ex final inclusiva

limitquery

integer

cursorquery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fiis/proventos?ticker=string&start_date=2026-01-01&end_date=2026-01-01&limit=2000&cursor=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "ticker": "string",
  "start_date": "string",
  "end_date": "string",
  "data": [
    {
      "empresa": "string",
      "isin": "string",
      "codigo_negociacao": "string",
      "especificacao": "string",
      "tipo_provento": "string",
      "data_aprovacao": "string",
      "valor_provento": 0,
      "data_pagamento": "string",
      "data_ex": "string",
      "data_com": "string",
      "exercicio": 0,
      "inicio_correcao": "string",
      "fim_correcao": "string",
      "provento_por_unidade": 0
    }
  ],
  "count": 0,
  "total_count": 0,
  "has_more": false,
  "next_cursor": "string"
}

GET/fiis/list

Listar Fiis

Listar FIIs, opcionalmente filtrados por ticker ou nome do fundo.

Autenticação: Bearer token

Parâmetros

queryquery

string

Filtro opcional por ticker ou nome do fundo

limitquery

integer

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fiis/list?query=string&limit=1000000' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "type": "string",
    "identifier": "string",
    "name": "string",
    "tp_fundo": "string",
    "short_name": "string"
  }
]

GET/fiis/indicadores

Listar Indicadores Fiis

Listar indicadores disponíveis para FIIs.

Autenticação: Bearer token

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fiis/indicadores' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "id": "string",
    "name": "string",
    "nome": "string",
    "description": "string",
    "category": "string"
  }
]

GET/fiis/indicadores/calcular

Calcular Indicadores Fii

Calcular indicadores específicos para um FII em uma data.

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker do FII

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m, proventos_1y, dividendyield_1y

reference_datequery

stringobrigatório

Data para calcular os indicadores

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fiis/indicadores/calcular?ticker=string&indicators=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string"
  }
]

GET/fiis/indicadores/historico

Calcular Indicadores Historico Fiis

Calcular indicadores para múltiplos FIIs em um intervalo de datas.

Autenticação: Bearer token

Parâmetros

start_datequery

stringobrigatório

Data inicial

end_datequery

stringobrigatório

Data final

periodicityquery

string

Periodicidade: daily, weekly, monthly, yearly

Valores aceitos

dailyweeklymonthlyyearly

tickersquery

string[]obrigatório

Lista de tickers dos FIIs

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, proventos_1y

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fiis/indicadores/historico?start_date=2026-01-01&end_date=2026-01-01&periodicity=daily&tickers=string&indicators=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string",
    "asset": {
      "asset_type": "fund",
      "asset_id": "string",
      "name": "string",
      "short_name": "string"
    }
  }
]

GET/fiis/historico

Serie Historica Fii

Histórico de FII (1 identificador)

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker do FII

start_datequery

stringobrigatório

end_datequery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fiis/historico?ticker=string&start_date=2026-01-01&end_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "patrimonio_liquido": 0
  }
]

GET/fiis/retorno-percentual

Retorno Percentual Fii

Retorno % de FII (1 identificador)

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker do FII

start_datequery

string

end_datequery

string

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fiis/retorno-percentual?ticker=string&start_date=2023-09-18&end_date=2026-01-01&direction=asc&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0
  }
]

GET/fiis/retorno-acumulado

Retorno Acumulado Fii

Retorno acumulado de FII (1 identificador)

Autenticação: Bearer token

Parâmetros

tickerquery

stringobrigatório

Ticker do FII

start_datequery

string

end_datequery

string

initial_valuequery

number

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/fiis/retorno-acumulado?ticker=string&start_date=2023-09-18&end_date=2026-01-01&initial_value=1&direction=asc&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0,
    "accumulated_return": 0
  }
]

macroeconomia

GET/macroeconomia/indicadores

Listar indicadores macroeconômicos

Lista apenas indicadores ANBIMA, Bacen e Ipea já armazenados.

Autenticação: Bearer token

Parâmetros

limitquery

integer

cursorquery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/macroeconomia/indicadores?limit=2000&cursor=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "data": [
    {
      "identifier": "string",
      "name": "string",
      "tipo_valor": "string",
      "periodicidade": "string"
    }
  ],
  "count": 0,
  "total_count": 0,
  "has_more": false,
  "next_cursor": "string"
}

GET/macroeconomia/serie-historica

Consultar série histórica macroeconômica

Retorna pontos numéricos armazenados, sem agregação ou preenchimento.

Autenticação: Bearer token

Parâmetros

identifierquery

stringobrigatório

Identificador da série

start_datequery

stringobrigatório

Data inicial inclusiva

end_datequery

stringobrigatório

Data final inclusiva

limitquery

integer

cursorquery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/macroeconomia/serie-historica?identifier=string&start_date=2026-01-01&end_date=2026-01-01&limit=2000&cursor=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "identifier": "string",
  "name": "string",
  "tipo_valor": "string",
  "periodicidade": "string",
  "start_date": "string",
  "end_date": "string",
  "data": [
    {
      "date": "string",
      "value": 0
    }
  ],
  "count": 0,
  "total_count": 0,
  "has_more": false,
  "next_cursor": "string"
}

GET/macroeconomia/retorno

Consultar retorno de série macroeconômica

Calcula retornos exclusivamente a partir dos pontos solicitados.

Autenticação: Bearer token

Parâmetros

identifierquery

stringobrigatório

Identificador da série

start_datequery

stringobrigatório

Data inicial inclusiva

end_datequery

stringobrigatório

Data final inclusiva

return_typequery

string

Valores aceitos

percentageaccumulated

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

initial_valuequery

number

limitquery

integer

cursorquery

string

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/macroeconomia/retorno?identifier=string&start_date=2026-01-01&end_date=2026-01-01&return_type=percentage&periodicity=daily&initial_value=1&limit=2000&cursor=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

{
  "identifier": "string",
  "name": "string",
  "tipo_valor": "string",
  "periodicidade": "string",
  "start_date": "string",
  "end_date": "string",
  "return_type": "percentage",
  "periodicity": "daily",
  "initial_value": 0,
  "data": [
    {
      "date": "string",
      "value": 0,
      "percentage_return": 0,
      "accumulated_return": 0
    }
  ],
  "count": 0,
  "total_count": 0,
  "has_more": false,
  "next_cursor": "string"
}

GET/macroeconomia/indicadores/calcular

Calcular indicadores macroeconômicos

Calcula indicadores em uma data para uma série de origem permitida.

Autenticação: Bearer token

Parâmetros

identifierquery

stringobrigatório

Identificador da série

indicatorsquery

arrayobrigatório

reference_datequery

stringobrigatório

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/macroeconomia/indicadores/calcular?identifier=string&indicators=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string"
  }
]

GET/macroeconomia/indicadores/historico

Calcular histórico de indicadores macroeconômicos

Calcula indicadores para séries e datas do intervalo solicitado.

Autenticação: Bearer token

Parâmetros

identifiersquery

string[]obrigatório

indicatorsquery

arrayobrigatório

start_datequery

stringobrigatório

end_datequery

stringobrigatório

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/macroeconomia/indicadores/historico?identifiers=string&indicators=string&start_date=2026-01-01&end_date=2026-01-01&periodicity=daily' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string",
    "asset": {
      "asset_type": "fund",
      "asset_id": "string",
      "name": "string",
      "short_name": "string"
    }
  }
]

screener

GET/screener

Screener

Screener diário sobre indicadores pré-calculados. Exemplos: - /screener?asset_type=acao&sort_by=return_12m&sort_dir=desc&limit=20 - /screener?asset_type=fii&sort_by=sharpe_30d&min_sharpe=1.0&max_vol=0.25 - /screener?sort_by=vol_6m&sort_dir=asc&limit=50

Autenticação: Bearer token

Parâmetros

asset_typequery

string

Tipo de ativo: acao, fii, etf, fund, etc

sort_byquery

string

Coluna para ordenar (ex: return_12m, sharpe_30d, vol_6m)

sort_dirquery

string

Direção: asc ou desc

limitquery

integer

Número máximo de resultados

offsetquery

integer

Offset para paginação

min_volquery

string

Volatilidade mínima (anualizada)

max_volquery

string

Volatilidade máxima (anualizada)

min_sharpequery

string

Sharpe mínimo

min_returnquery

string

Retorno mínimo (período derivado do sort_by ou 12m)

reference_datequery

string

Data de referência (padrão: última disponível)

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/screener?asset_type=acao&sort_by=return_12m&sort_dir=desc&limit=50&offset=0&min_vol=0&max_vol=0&min_sharpe=0&min_return=0&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "asset_id": "string",
    "asset_type": "string",
    "dt_comptc": "2026-01-01",
    "return_7d": "string",
    "return_30d": "string",
    "return_3m": "string",
    "return_6m": "string",
    "return_12m": "string",
    "return_24m": "string",
    "return_36m": "string",
    "return_48m": "string",
    "return_60m": "string",
    "vol_7d": "string",
    "vol_30d": "string",
    "vol_3m": "string",
    "vol_6m": "string",
    "vol_12m": "string",
    "vol_24m": "string",
    "vol_36m": "string",
    "vol_48m": "string",
    "vol_60m": "string",
    "sharpe_7d": "string",
    "sharpe_30d": "string",
    "sharpe_3m": "string",
    "sharpe_6m": "string",
    "sharpe_12m": "string",
    "sharpe_24m": "string",
    "sharpe_36m": "string",
    "sharpe_48m": "string",
    "sharpe_60m": "string",
    "last_price": "string"
  }
]

titulos-publicos

GET/titulos-publicos/list

Listar Titulos Publicos

Listar títulos públicos, opcionalmente filtrados por ISIN, tipo ou código SELIC.

Autenticação: Bearer token

Parâmetros

queryquery

string

Filtro opcional por código ISIN, tipo de título ou código SELIC

limitquery

integer

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/titulos-publicos/list?query=string&limit=1000000' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "type": "string",
    "identifier": "string",
    "name": "string",
    "tp_fundo": "string",
    "short_name": "string"
  }
]

GET/titulos-publicos/indicadores

Listar Indicadores Titulos Publicos

Listar indicadores disponíveis para Títulos Públicos.

Autenticação: Bearer token

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/titulos-publicos/indicadores' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "id": "string",
    "name": "string",
    "nome": "string",
    "description": "string",
    "category": "string"
  }
]

GET/titulos-publicos/indicadores/calcular

Calcular Indicadores Titulo Publico

Calcular indicadores específicos para um Título Público em uma data.

Autenticação: Bearer token

Parâmetros

codigo_isinquery

stringobrigatório

Código ISIN do Título Público

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m

reference_datequery

stringobrigatório

Data para calcular os indicadores

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/titulos-publicos/indicadores/calcular?codigo_isin=string&indicators=string&reference_date=2026-01-01' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string"
  }
]

GET/titulos-publicos/indicadores/historico

Calcular Indicadores Historico Titulos Publicos

Calcular indicadores para múltiplos Títulos Públicos em um intervalo de datas.

Autenticação: Bearer token

Parâmetros

start_datequery

stringobrigatório

Data inicial

end_datequery

stringobrigatório

Data final

periodicityquery

string

Periodicidade: daily, weekly, monthly, yearly

Valores aceitos

dailyweeklymonthlyyearly

codigos_isinquery

string[]obrigatório

Lista de códigos ISIN dos Títulos Públicos

indicatorsquery

arrayobrigatório

Lista de indicadores a calcular. Exemplos: return_1y, volatility_30d, sharpe_12m

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/titulos-publicos/indicadores/historico?start_date=2026-01-01&end_date=2026-01-01&periodicity=daily&codigos_isin=string&indicators=string' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "indicator": "string",
    "value": 0,
    "start_date": "2026-01-01",
    "date": "2026-01-01",
    "type": "float",
    "nome": "string",
    "error": false,
    "error_message": "string",
    "asset": {
      "asset_type": "fund",
      "asset_id": "string",
      "name": "string",
      "short_name": "string"
    }
  }
]

GET/titulos-publicos/historico

Serie Historica Titulo Publico

Histórico de Título Público (1 identificador)

Autenticação: Bearer token

Parâmetros

codigo_isinquery

stringobrigatório

Código ISIN do Título Público

start_datequery

stringobrigatório

end_datequery

stringobrigatório

marcacaoquery

string

Tipo de marcação da série histórica

Valores aceitos

pu_anbimapu_parpu_comprataxa_indicativataxa_comprataxa_venda

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/titulos-publicos/historico?codigo_isin=string&start_date=2026-01-01&end_date=2026-01-01&marcacao=pu_anbima' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "patrimonio_liquido": 0
  }
]

GET/titulos-publicos/retorno-percentual

Retorno Percentual Titulo Publico

Retorno % de Título Público (1 identificador)

Autenticação: Bearer token

Parâmetros

codigo_isinquery

stringobrigatório

Código ISIN do Título Público

start_datequery

string

end_datequery

string

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

marcacaoquery

string

Tipo de marcação usada no retorno percentual

Valores aceitos

pu_anbimapu_parpu_comprataxa_indicativataxa_comprataxa_venda

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/titulos-publicos/retorno-percentual?codigo_isin=string&start_date=2023-09-18&end_date=2026-01-01&direction=asc&periodicity=daily&marcacao=pu_anbima' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0
  }
]

GET/titulos-publicos/retorno-acumulado

Retorno Acumulado Titulo Publico

Retorno acumulado de Título Público (1 identificador)

Autenticação: Bearer token

Parâmetros

codigo_isinquery

stringobrigatório

Código ISIN do Título Público

start_datequery

string

end_datequery

string

initial_valuequery

number

directionquery

string

Valores aceitos

ascdesc

periodicityquery

string

Valores aceitos

dailyweeklymonthlyyearly

marcacaoquery

string

Tipo de marcação usada no retorno acumulado

Valores aceitos

pu_anbimapu_parpu_comprataxa_indicativataxa_comprataxa_venda

REQUISIÇÃOcURL / JSON

curl --request GET \
  --url 'https://assets.atlasfin.com.br/titulos-publicos/retorno-acumulado?codigo_isin=string&start_date=2023-09-18&end_date=2026-01-01&initial_value=1&direction=asc&periodicity=daily&marcacao=pu_anbima' \
  --header 'Authorization: Bearer SEU_TOKEN'

RESPOSTA

Successful Response application/json

[
  {
    "date": "2026-01-01",
    "value": 0,
    "percentage_return": 0,
    "accumulated_return": 0
  }
]