Fintatica
Home
WebsiteContato
Home
WebsiteContato
  1. FAQ
  • Getting started
    • Introduction
    • Quick start
    • SDKs & Libraries
    • Authentication & Limits
    • Error Codes
    • Common Params
  • Investment Funds
    • Retrive Portifolio
      GET
    • FOF Portifolio Look-Through
      GET
  • Others
    • Flight Fares
      GET
  • FAQ
    • FAQ
  1. FAQ

FAQ

FAQ#

Below are the most common questions about Fintatica—from getting started and handling data nuances to pricing and roadmap. If you don’t see your question here, email contato@fintatica.com.br.

Roadmap & Coverage#

Can you add dataset X?#

Yes—this is a priority for us. Email contato@fintatica.com.br with:
Your use case (who uses it and why it matters),
Concrete fields you need,
Update cadence you expect,
Any public references to the source.
We prioritize based on user demand + feasibility. New datasets and expansions are announced in the Changelog.

What datasets do you currently cover?#

We publish Brazilian market datasets focused on CVM / B3 / IBGE. Each dataset page documents fields, cadence, examples, and caveats. See the Datasets section in the docs to explore.

Getting Started#

Where do I get an API key?#

During onboarding we issue your key. Until the dashboard is live, email support if you need a change (revoke/regenerate).

How do I make my first request?#

See Quick Start. In short:
Base URL: https://api.fintatica.com.br/v1
Auth: Authorization: Bearer <YOUR_API_KEY>
Try: GET /v1/funds?page=0&page_size=100

Authentication & Security#

What auth do you support?#

Header-only Bearer tokens:
Authorization: Bearer <YOUR_API_KEY>

Can I use multiple API keys?#

Not self-serve yet, but you can request additional keys via email and we’ll provision as needed.

Should I call the API from a public frontend?#

No. Keep your key on your backend (server-side), store it in a secrets manager or environment variable, and proxy requests from your app.

What if my key is exposed?#

Email contato@fintatica.com.br to revoke it and issue a new one. Update all deployments and redeploy.

Usage, Limits & Performance#

What are the rate limits?#

Default is 100 requests/minute per API key. We can adjust limits upon request. Details and headers (X-RateLimit-*, Retry-After) are in Authentication & Limits.

How does pagination work?#

Use page (zero-based) and page_size. Default is page=0, page_size=100, max page_size=1000. Responses don’t include total; stop when a page returns fewer items than requested. See Common Params.

Which date formats do you accept?#

Strictly YYYYMMDD for date, from, and to. Ranges are inclusive. See Common Params.

What about timezones and business days?#

Timestamps are UTC unless an endpoint explicitly documents Brazil Time. Some datasets align to Brazilian business calendars—check each endpoint page.

Should I cache responses?#

Yes—cache by dataset cadence (daily/weekly/monthly) and periodically re-pull recent historical windows to capture revisions/backfills (see below).

Data Behavior & Comparisons#

Do you mirror source revisions/backfills?#

Usually yes, but it depends on the source. In some cases we may clean values or document changes in the Changelog instead of mirroring. Each endpoint page explains its revision behavior.

Why do my numbers differ from another vendor?#

Common reasons:
Cadence mismatch (daily vs weekly vs monthly),
Different definitions (index membership timing, fund hierarchies),
Source revisions/backfills,
Timezone/business-day alignment.
Check the dataset page for definitions and cadence notes; then align your comparison accordingly.

How should I report a data issue?#

Email contato@fintatica.com.br with:
X-Request-Id from the response headers,
Endpoint + query params,
A short snippet of the response,
What you expected vs what you observed,
Time of the request (UTC).

Errors & Troubleshooting#

What does an error response look like?#

All errors are JSON:
{
  "success": false,
  "message": "Human-readable message",
  "code": "machine_readable_code",
  "error_data": {}
}
Validation errors include structured details (error flatten format). See Error Codes for the full table.

I got 401 vs 403—what’s the difference?#

401 not_authorized: missing/invalid token (server doesn’t know who you are).
403 forbidden: token recognized, but you’re not allowed to access that resource.

I hit rate limits—what now?#

Honor Retry-After, implement exponential backoff + jitter, and consider smaller page_size and lower concurrency. See Authentication & Limits.

Formats & Downloads#

Which output formats are supported?#

Default is JSON. Some endpoints may support format=csv or format=xml for example. Use download=true to set Content-Disposition: attachment and trigger download in the browser. Details live on each endpoint page;

Pricing, Plans & “Enterprise” Options#

How is pricing structured?#

Customized. Pricing depends on the endpoints and conditions (e.g., cadence, volume) you want. Contact us at contato@fintatica.com.br with your needs and we’ll propose a plan.

Do you offer “enterprise” features?#

Yes—available upon request:
Custom rate limits / throughput
Multiple API keys
Priority support
Custom contracts & invoicing
Data export jobs (bulk dumps)

Procurement/legal reviews, DPA, data residency?#

Contact us with your requirements. We can share architecture notes, data source lineage, and discuss contractual terms as needed.

Docs, SDKs & Changelog#

Do you have SDKs or an OpenAPI spec?#

JS/Python SDKs are coming soon; we’ll publish links in the docs. We may also share a Postman collection or OpenAPI spec—watch the Changelog.

How will I learn about breaking changes?#

We announce behavior changes, new fields, and deprecations in the Changelog with reasonable notice.

Support & Status#

How do I reach support?#

Email contato@fintatica.com.br. Include X-Request-Id, endpoint, params, and a brief description.

Where can I check uptime or incidents?#

Our status page is https://status.fintatica.com.br. Subscribe there to follow incidents and maintenance windows.
If something’s missing from this FAQ, tell us. The page evolves with your questions and helps make the whole product better.
Previous
Flight Fares
Built with