Carteiras e análises

Listar carteiras

Carteiras salvas na sua conta, com a versão mais recente das posições (pesos em %). Use o slug ou o id para rodar as análises.

GEThttps://api.fintay.com.br/v1/portfolios

Autorização

X-API-Keystringheaderobrigatório

Chave de API criada em API Keys. Veja Chaves e limites.

Resposta

Envelope { success, data, meta }. Campos de data.items[]:

idstring

Exemplo: 5b0e2c1a-7d3f-4a51-9b8e-2f64c0a1d9e7

namestring

Exemplo: Renda e dividendos

slugstring

Exemplo: renda-e-dividendos

notesnull

benchmark_idnull

updated_atstring

Exemplo: 2026-10-10T14:02:11.482913+00:00

versioninteger

Exemplo: 3

itemsobject[]

benchmark_namenull

GETListar carteiras

curl "https://api.fintay.com.br/v1/portfolios" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "5b0e2c1a-7d3f-4a51-9b8e-2f64c0a1d9e7",
        "name": "Renda e dividendos",
        "slug": "renda-e-dividendos",
        "notes": null,
        "benchmark_id": null,
        "updated_at": "2026-10-10T14:02:11.482913+00:00",
        "version": 3,
        "items": [
          {
            "series_id": "f084283b-3140-4ab0-b6ba-0140fe1fc961",
            "code": "TAEE11",
            "name": "Transmissora Alianca De Energia Eletrica S.A. Unit",
            "asset_class": "unit",
            "frequency": "daily",
            "token": "TAEE11",
            "weight": 50,
            "group": "unit"
          },
          {
            "series_id": "…",
            "code": "CDI",
            "name": "CDI",
            "asset_class": "juros",
            "frequency": "daily",
            "token": "CDI",
            "weight": 50,
            "group": "juros"
          }
        ],
        "benchmark_name": null
      }
    ],
    "limit": 10
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}