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

# Quick Start

> Make your first API call in 60 seconds

<Info>
  **Time to first call: \~60 seconds.** Get your API key from the [Developer Portal](https://app.podium.build/onboarding) — sign in, and your key is generated automatically. Free plan, no credit card.
</Info>

## 1. Get Your API Key

Head to [app.podium.build/onboarding](https://app.podium.build/onboarding) and sign in. Your API key is generated instantly.

## 2. Make Your First Call

Paste this into your terminal (replace the key):

```bash theme={null}
curl https://api.podium.build/api/v1/products \
  -H "Authorization: Bearer YOUR_API_KEY"
```

A successful response returns a JSON array of products scoped to your organization.

## 3. Try the SDK

```bash theme={null}
npm install @podium-sdk/node-sdk
```

```typescript theme={null}
import { createPodiumClient } from '@podium-sdk/node-sdk'

const client = createPodiumClient({
  apiKey: process.env.PODIUM_API_KEY!,
})

// List products
const products = await client.product.list({ page: 1, limit: 5 })
console.log(products)

// Or search across entities
const results = await client.search.search({
  query: 'vitamin c serum',
  limit: 5,
})
console.log(results)
```

<Tip>
  The SDK auto-detects staging vs production from your key prefix (`podium_test_` vs `podium_live_`). Ships with full TypeScript types from the OpenAPI spec.
</Tip>

## 4. Explore

<CardGroup cols={2}>
  <Card title="API Playground" icon="play" href="https://api.podium.build/docs">
    Try endpoints live — paste your key and send requests
  </Card>

  <Card title="Build a Shopping Agent" icon="robot" href="/docs/recipes/shopping-agent">
    Full tutorial: memory, scoring, checkout, and settlement
  </Card>

  <Card title="Agent Tooling" icon="wrench" href="/docs/ai-tools/overview">
    Plug Podium into Claude, Cursor, LangChain, or any MCP runtime
  </Card>

  <Card title="Machine Payments" icon="coins" href="/docs/agentic/x402-payments">
    Autonomous USDC settlement on Base
  </Card>
</CardGroup>

## API Key Details

Keys are prefixed by environment:

| Prefix         | Environment | API Base URL                                   |
| -------------- | ----------- | ---------------------------------------------- |
| `podium_test_` | Staging     | `https://podium-staging.up.railway.app/api/v1` |
| `podium_live_` | Production  | `https://api.podium.build/api/v1`              |

<Warning>
  Your full API key is only shown once at creation time. Copy it immediately and store it securely. The dashboard only displays the key prefix after that.
</Warning>

Manage keys from the [Dashboard](https://app.podium.build/dashboard/settings/api-keys) — create, rotate, enable/disable, or delete.

## Pricing

| Tier        | Price    | Requests/Month | Rate Limit |
| ----------- | -------- | -------------- | ---------- |
| **Builder** | Free     | 10,000         | 5/sec      |
| **Growth**  | \$99/mo  | 100,000        | 20/sec     |
| **Pro**     | \$499/mo | 1,000,000      | 100/sec    |

[See full pricing →](https://podium.build/pricing)

## Ready to build?

<CardGroup cols={3}>
  <Card title="Build an Agent" icon="robot" href="/docs/agentic/overview">
    Intelligent commerce agents with memory, scoring, and settlement
  </Card>

  <Card title="Commerce API" icon="cart-shopping" href="/docs/api-reference/introduction">
    Products, orders, checkout, creators, payments, and more
  </Card>

  <Card title="Smart Contracts" icon="link" href="/docs/contracts/overview">
    On-chain Task Pool, solver reputation, and USDC settlement on Base
  </Card>
</CardGroup>