> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finvera.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

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

<div
  style={{
background: "#222222",
padding: "32px",
borderRadius: "16px",
textAlign: "center",
color: "#fff",
boxShadow: "0 8px 20px rgba(0,0,0,0.3)",
margin: "16px auto",
class:"w-full"
}}
>
  <div
    style={{
    fontSize: "1.8rem",
    fontWeight: "700",
    margin: "0 0 12px 0",
    display: "flex",
    alignItems: "center",
    color: "white",
    justifyContent: "center",
    gap: "0.5rem"
}}
  >
    <span>Get Started with Finvera</span>
  </div>

  <p style={{ fontSize: "1.05rem", margin: "0 0 20px 0", color: "#d1d5db" }}>
    Create your free trial API key to start exploring our financial datasets.
  </p>

  <a href="https://dashboard.finvera.ai/sign-up" target="_blank">
    <button
      style={{
        backgroundColor: "#fff",
        color: "#000",
        padding: "14px 28px",
        borderRadius: "10px",
        fontWeight: "700",
        fontSize: "1.05rem",
        cursor: "pointer",
        border: "none",
        transition: "all 0.2s ease-in-out"
    }}
      onMouseOver={(e) => { e.currentTarget.style.backgroundColor = "#f3f4f6"; }}
      onMouseOut={(e) => { e.currentTarget.style.backgroundColor = "#fff"; }}
    >
      Open Dashboard →
    </button>
  </a>
</div>

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

<Tip>
  Fetch your API key in the [API Key Management Dashboard](https://dashboard.finvera.ai/sign-up).
</Tip>

For example:

```json theme={null}
https://api.finvera.news/delivery/api/v1/calls?apikey=123456789
```

More details on alternative authentication methods such as JWT Authentication can be found [here](https://docs.finvera.ai/api-reference/authentication).

## 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](https://docs.finvera.ai/api-reference/error-handling).

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