Quickstart - Radion

Get an API key and make your first API call.

1. Get an API key

You manage API keys at radion.app/dashboard. Sign in and create your free key. Keys start with sk_. Move to a paid plan to drop the per-second rate limit and raise your monthly quota.

2. Check your key

Make sure your key works before you build:

curl "https://api.radion.app/auth/me" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "keyLabel": "production_read",
  "plan": "free",
  "callCount": 0,
  "createdAt": "2026-04-01T12:00:00Z",
  "lastUsedAt": null,
  "monthlyUsage": {
    "used": 0,
    "limit": 300,
    "resetsAt": "2026-07-01T00:00:00Z"
  },
  "requestsPerSecond": 5
}

If you get this back, your key works. You are ready to make requests.

3. Get an event

Read one Polymarket event by its id or URL slug. For example, will-bitcoin-close-above-100k:

curl "https://api.radion.app/v1/polymarket/events/will-bitcoin-close-above-100k" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "id": "12345",
  "slug": "will-bitcoin-close-above-100k",
  "title": "Will Bitcoin close above $100k?",
  "description": "Resolves Yes if BTC closes above $100,000.",
  "closed": false,
  "volume": 4820000,
  "startDate": 1714521600,
  "endDate": 1735689600,
  "marketCount": 1,
  "markets": [
    {
      "conditionId": "0x1234567890abcdef1234567890abcdef12345678",
      "question": "Will Bitcoin close above $100k?",
      "status": "open",
      "outcomes": [
        { "label": "Yes", "tokenId": "123456789" },
        { "label": "No", "tokenId": "987654321" }
      ]
    }
  ]
}

Reading the response

Field	What it tells you
`id`	The event id (numeric string)
`title`	The event title
`slug`	The event’s URL slug
`closed`	Whether the event is closed
`startDate`	When the event opened (Unix time, seconds)
`endDate`	When the event ends (Unix time, seconds)
`markets`	The markets inside the event, each with its `outcomes`

4. List events by volume

Get the top events, ordered by trade volume. Use limit to set the page size and cursor to page through.

curl "https://api.radion.app/v1/polymarket/events?limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

Events and markets list endpoints return their array under events or markets, plus a nextCursor. Pass nextCursor back as the cursor query parameter to get the next page. See Pagination.

5. Search Polymarket

Search across events, themes, and profiles by text. Use limit for the page size and page to move through results.

curl "https://api.radion.app/v1/polymarket/search?q=bitcoin&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

Next steps

Onchain Data

Learn how Radion reads Polymarket contract events.

API Reference

Full endpoint reference with schemas and examples.

Use Radion with AI

Connect Radion to Claude, Cursor, and other AI tools.

WebSockets

Stream trades and market events live.

​1. Get an API key

​2. Check your key

​3. Get an event

​Reading the response

​4. List events by volume

​5. Search Polymarket

​Next steps