Introduction - API Reference

Finvera provides a powerful API for accessing financial data efficiently. Below are the key concepts to understand before integrating.

Introduction

The Finvera API enables developers to retrieve financial data, including insider transactions, market data, earnings call transcripts, and more.

Authentication

All API requests require authentication using Bearer tokens. Obtain your token from the Finvera dashboard and include it in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

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.

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.

Authentication

All API endpoints are authenticated using Bearer tokens and picked up from the specification file.

"security": [
  {
    "bearerAuth": []
  }
]