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

# Get Started with RetinaOS: Your First API Call in Minutes

> Create your RetinaOS account, generate an API key, and make your first live on-chain data query against Robinhood Chain in under five minutes.

RetinaOS gives you instant access to real-time Robinhood Chain data. This guide walks you through creating an account, obtaining an API key, and making your first API call to explore token data.

<Steps>
  <Step title="Visit Retina Terminal">
    Navigate to [app.retinaos.xyz](https://app.retinaos.xyz). The discovery feed loads immediately — no login required. Browse trending tokens on Robinhood Chain without signing up.
  </Step>

  <Step title="Create Your Account">
    Click **Sign Up** in the top right. Enter your email and a strong password. Verify your email address from the confirmation link sent to your inbox.
  </Step>

  <Step title="Get Your API Key">
    Once signed in, go to **Settings → API Keys**. Click **Generate New Key**. Copy and store your key securely — it is shown only once. Your key grants access to the RetinaOS Public API on the Free tier by default.
  </Step>

  <Step title="Make Your First API Call">
    Use the following request to fetch the current trending tokens on Robinhood Chain:

    ```bash theme={null}
    curl -X GET https://api.retinaos.xyz/v1/tokens \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Accept: application/json"
    ```

    A successful response returns a paginated list of tokens with AI-generated summaries and risk scores:

    ```json theme={null}
    {
      "tokens": [
        {
          "address": "0xabc123...",
          "name": "ExampleToken",
          "symbol": "EXT",
          "market_cap_usd": 1200000,
          "volume_24h_usd": 340000,
          "liquidity_usd": 180000,
          "holder_count": 412,
          "risk_score": 28,
          "ai_summary": "Momentum building since 06:00 UTC driven by 3 Early Mover wallets accumulating. Liquidity stable."
        }
      ],
      "total": 100,
      "page": 1
    }
    ```
  </Step>

  <Step title="Set Your First Alert">
    In Retina Terminal, click the bell icon on any token page or go to **Alerts → New Alert**. Set a filter (e.g., market cap \< $2M, liquidity \> $100K, no critical risk flags) and choose a notification method (email or push). You will be notified when a matching token appears.
  </Step>
</Steps>

<Tip>
  The Free tier allows up to 100 API requests per day. Upgrade to Pro for unlimited queries, wallet following, and advanced alerts.
</Tip>

## What Next?

<CardGroup cols={2}>
  <Card title="Data Model" icon="database" href="/concepts/data-model">
    Understand tokens, wallets, and events
  </Card>

  <Card title="Discovery Feed" icon="chart-bar" href="/retina-terminal/discovery-feed">
    Explore the trending feed in depth
  </Card>

  <Card title="API Reference" icon="code" href="/api/overview">
    Full API documentation
  </Card>

  <Card title="Connect a Wallet" icon="wallet" href="/getting-started/connect-wallet">
    Personalize your feed
  </Card>
</CardGroup>
