CVM funds & portfolios — including fund-of-funds look-through.
B3 index constituents — index membership by day.
IBGE airline fares for IPCA — inputs used to build inflation sub-indices.
Clear, consistent JSON responses.
Versioned base URL: https://api.fintatica.com.br/v1
(No sandbox yet; production only.)
Endpoint-level freshness: some endpoints update daily, others weekly or monthly depending on the source. Each endpoint page states its cadence.
Quick Start — your first successful request in minutes.
Authentication & Limits — how to pass your API key and understand rate limits.
Error Codes — status codes, error shapes, and how to recover.
Common Params — pagination, filtering, date ranges, and sorting conventions.
Dataset Pages — one page per dataset with fields, examples, and update cadence.
FAQ — short answers to common “why is this number different?” questions.
What this endpoint returns (with a sample response),
Field reference (names, types, nullability),
Update cadence & revision notes (can values be backfilled/updated?),
Source & attribution (direct links to CVM/B3/IBGE materials),
Usage examples (curl + code once SDKs are live),
Known caveats specific to Brazilian market conventions.
1.
New to Fintatica? Start with Quick Start → then skim Common Params.
2.
Know what you need? Jump straight to the dataset page (e.g., CVM Funds, B3 Indexes, IBGE Fares).
3.
Integrating into production? Read Authentication & Limits and Error Codes, then bookmark the Changelog and Status.
Per-endpoint cadence: Not all sources update daily. Each endpoint page states when it updates and if historical values can be revised by the source.
Data lineage & attribution: We link to the official sources on every dataset page so you can trace values end-to-end.
Formats: Responses are JSON by default. If an endpoint supports CSV/Parquet, it will say so on that page.
Versioning: You’re on v1. We aim for additive changes within a version. If we need to deprecate something, we’ll announce it in the Changelog with reasonable notice.
Time & locale: Endpoint pages state timestamp conventions. Unless noted otherwise, timestamps follow standard ISO-8601 formatting.
Cadence differences: Comparing daily and monthly series without aligning frequencies creates false discrepancies. Check the cadence.
Revisions/backfills: Some official sources revise prior periods. If you cache aggressively, plan for occasional updates to historical rows.
Brazil-specific conventions: Index membership dates, fund class hierarchies, and identifier changes can be non-obvious—dataset pages call out the gotchas.
Pagination & filtering: Use the patterns in Common Params to avoid timeouts and to make your fetches rate-limit friendly.
