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

# RetinaOS API Tier: Usage-Based Access for Developers

> The RetinaOS API Tier gives developers and agent builders usage-based access to all public API endpoints with custom rate limits and no daily cap.

The RetinaOS API Tier is designed for developers, quantitative traders, and AI agent builders who need high-volume, reliable programmatic access to Robinhood Chain data. It removes daily request caps and offers custom rate limits negotiated for your use case.

## What Is Included

* Unlimited daily API requests (no daily cap)
* Custom per-minute rate limits based on your tier
* Access to all public API endpoints: `/tokens`, `/wallets`, `/scores`, `/events`, `/alerts`
* AI summaries via the API
* Historical data access (token and wallet history)
* Priority support response time

## Use Cases

<CardGroup cols={2}>
  <Card icon="robot" title="AI Agents">
    Feed real-time on-chain reputation data into autonomous trading agents.
  </Card>

  <Card icon="chart-bar" title="Quant Research">
    Pull historical wallet behavior and token data for model training.
  </Card>

  <Card icon="code" title="Product Integrations">
    Embed RetinaOS token and wallet scores in your own app or dashboard.
  </Card>

  <Card icon="bell" title="Custom Alerts">
    Build your own alerting layer on top of the RetinaOS event stream.
  </Card>
</CardGroup>

## Pricing

API Tier pricing is usage-based. Your tier is determined by monthly request volume:

| Monthly Requests | Tier    | Notes              |
| ---------------- | ------- | ------------------ |
| Up to 300K       | Starter | Fixed monthly rate |
| 300K – 1M        | Growth  | Fixed monthly rate |
| 1M+              | Scale   | Custom contract    |

<Info>
  API Tier pricing will be finalized at launch. Contact the RetinaOS team for early-access pricing or to discuss a custom arrangement for high-volume use cases.
</Info>

## Getting Started on API Tier

<Steps>
  <Step title="Sign in to app.retinaos.xyz">
    Navigate to [app.retinaos.xyz](https://app.retinaos.xyz) and sign in to your account.
  </Step>

  <Step title="Go to Settings → Subscription → API Tier">
    Open the account menu, navigate to **Settings**, select the **Subscription** tab, then choose **API Tier**.
  </Step>

  <Step title="Select your tier or contact the team">
    Choose the Starter or Growth tier, or reach out to the RetinaOS team to discuss a custom volume arrangement for Scale-level usage.
  </Step>

  <Step title="Generate a dedicated API key">
    Go to **Settings → API Keys** and generate a dedicated key for your API Tier account.
  </Step>

  <Step title="Authenticate all requests">
    Pass your key in the `Authorization: Bearer` header on every API request.
  </Step>
</Steps>

## Rate Limit Headers

Every API response includes headers to help you track and manage your consumption:

```http theme={null}
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 874
X-RateLimit-Reset: 1705305600
Retry-After: 30  (only on 429 responses)
```

| Header                  | Description                                                       |
| ----------------------- | ----------------------------------------------------------------- |
| `X-RateLimit-Limit`     | The maximum number of requests allowed in the current window      |
| `X-RateLimit-Remaining` | The number of requests remaining before the window resets         |
| `X-RateLimit-Reset`     | Unix timestamp (UTC) when the current rate limit window resets    |
| `Retry-After`           | Seconds to wait before retrying — only present on `429` responses |

## SLA and Support

API Tier customers receive a target uptime SLA and priority support response times. Full SLA details will be confirmed at launch.

For questions about enterprise arrangements, high-volume contracts, or early-access pricing, contact the RetinaOS team directly.