Quickstart

Your first API call in 60 seconds.

1. Get your API key

Pick a plan at roxyapi.com/pricing. The key lands in your inbox seconds after checkout. No account, no approval.

Want to try before paying? The API Playground ships with a pre-filled test key. Make live calls from your browser, zero signup.

2. Call your first endpoint

Pick a language tab and paste.

curl -X POST https://roxyapi.com/api/v2/tarot/daily \
  -H "X-API-Key: $ROXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

npm install @roxyapi/sdk

import { createRoxy } from '@roxyapi/sdk';

const roxy = createRoxy(process.env.ROXY_API_KEY!);

const { data } = await roxy.tarot.getDailyCard({ body: {} });
console.log(data.card.name);      // "The Star"
console.log(data.dailyMessage);   // concise daily guidance

pip install roxy-sdk

from roxy_sdk import create_roxy

roxy = create_roxy("your-api-key")

card = roxy.tarot.get_daily_card()
print(card["card"]["name"])       # "The Star"
print(card["dailyMessage"])

claude mcp add-json --scope user roxy-tarot \
  '{"type":"http","url":"https://roxyapi.com/mcp/tarot","headers":{"X-API-Key":"YOUR_KEY"}}'

3. See the response

{
  "date": "2026-04-23",
  "card": {
    "name": "The Star",
    "arcana": "major",
    "keywords": ["Hope", "faith", "renewal"],
    "meaning": "A welcome reprieve after upheaval...",
    "imageUrl": "https://roxyapi.com/img/tarot/major/star.jpg"
  },
  "dailyMessage": "Your card for today: The Star..."
}

That is it. Every Roxy endpoint works the same way: send a request, get typed JSON back.

What to do next

• Ship production code. The SDK guide covers the typed TypeScript and Python clients, error handling, and framework examples.
• Build with AI agents. The MCP guide covers Claude Code, Cursor, Antigravity, Claude Desktop, and custom Streamable HTTP clients. One command per tool, then the agent picks the right endpoint from natural language.
• Pick the right endpoint. Every domain guide lists the most-used endpoints in order, with copy-paste code per domain.
• Browse every endpoint. The API reference has a pre-filled test key and lets you call any of the 130+ endpoints live in the browser.

Prefer to vibe-code?

If you are building in Cursor, Claude Code, Bolt, Lovable, or Next.js, paste one of our AI Prompts and the agent scaffolds a working app end to end. No endpoint-picking required.