Introduction

The Finvera API enables developers to retrieve various financial datasets that power firms from fintech startups, to enterprise brokerage applications.

Get Started with Finvera

Create your free trial API key to start exploring our financial datasets.

Open Dashboard →

Authentication

All Finvera API endpoints are authenticated using query parameter authentication. Once you have copied the key from the dashboard, you can authenticate the endpoint.

Fetch your API key in the API Key Management Dashboard.

For example:

https://api.finvera.news/delivery/api/v1/calls?apikey=123456789

More details on alternative authentication methods such as JWT Authentication can be found here.

Rate Limits

To ensure fair usage and system stability, we enforce rate limits:

• Standard Tier: 60 requests per minute
• Enterprise Tier: Custom rate limits available If you exceed your rate limit, you will receive a 429 Too Many Requests response. Consider implementing exponential backoff when retrying requests.

More information on error handling can be found here.

Query Parameters

To optimize data retrieval, the API supports query parameters for filtering and pagination.

Common Query Parameters:

• limit: Number of results per request (default: 50, max: 500)
• offset: Pagination offset for large result sets
• sort: Sort results by a specific field (asc or desc)
• date_range: Filter results within a specific date range (YYYY-MM-DD format)
• symbol: Retrieve data for a specific stock ticker

Best Practices for API Performance

1. Use Pagination: Avoid retrieving large datasets in a single request.
2. Cache Responses: Use Redis or other caching mechanisms to store frequent queries.
3. Optimize Queries: Filter data at the API level to reduce response payloads.
4. Batch Requests: When possible, use batch endpoints instead of multiple single calls.
5. Monitor Usage: Use AltData’s API analytics to track usage and optimize accordingly.

For further details, explore each API section with code examples and integration tips.