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.

1. Visit Retina Terminal

   Navigate to app.retinaos.xyz. The discovery feed loads immediately — no login required. Browse trending tokens on Robinhood Chain without signing up.

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

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

4. Make Your First API Call

   Use the following request to fetch the current trending tokens on Robinhood Chain:

   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:

   {
     "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
   }
   
5. 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.

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

What Next?

Data Model

Understand tokens, wallets, and events

Discovery Feed

Explore the trending feed in depth

API Reference

Full API documentation

Connect a Wallet

Personalize your feed