To create your free trial API key, you can head over to the API Key Management Dashbord.

​
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. 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.