Skip to main content

​
1. Create Your Account

1

Sign up

Head to the Podium Developer Portal and sign in with email, Google, or a crypto wallet (powered by Privy).
2

Create an organization

During onboarding you’ll create an Organization — this is your tenant. All API keys, products, orders, and data are scoped to your organization.
3

Choose a plan

Pick a subscription tier that matches your usage. You can upgrade any time from the dashboard.
TierPriceRequests/MonthRate Limit
BuilderFree10,0005/sec
Growth$99/mo100,00020/sec
Pro$499/mo1,000,00050/sec
EnterpriseCustomUnlimitedCustom
4

Generate an API key

The onboarding flow generates your first API key automatically. You can create additional keys from Dashboard > Settings > API Keys.Keys are prefixed by environment:
PrefixEnvironmentAPI Base URL
podium_test_Staginghttps://podium-staging.up.railway.app/api/v1
podium_live_Productionhttps://api.podium.build/api/v1
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.

​
2. Make Your First Call

Verify your key works by listing products: 
curl -X GET https://api.podium.build/api/v1/products \
  -H "Authorization: Bearer podium_live_your_key_here"
A successful response returns a JSON array of products scoped to your organization.

​
3. Install the TypeScript SDK

The SDK auto-detects staging vs production from your key prefix: 
npm install @podium-sdk/node-sdk

import { createPodiumClient } from '@podium-sdk/node-sdk'

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

// The SDK is organized by namespace
const products = await client.product.list({ page: 1 })
const creator  = await client.merchant.getBySlug({ slug: 'clean-beauty-co' })
const user     = await client.user.getUsernameByUsername({ username: 'jane' })
The SDK is published as @podium-sdk/node-sdk on npm. It ships with full TypeScript types generated from the OpenAPI spec.

​
4. Explore the API

Interactive Docs

Try endpoints live with the Scalar API playground — paste your key and send requests

OpenAPI Spec

Download the full OpenAPI 3.1 spec for code generation or import into Postman

​
5. Choose Your Path

Build an Agent

Use the agentic product feed, companion API, and x402 payments to build intelligent commerce agents

Commerce API

Products, orders, checkout, creators, payments, points, campaigns, and NFTs

Smart Contracts

On-chain Task Pool, solver reputation, and USDC settlement on Base

​
6. Manage Your Keys

From the Dashboard you can:
  • Create additional API keys (up to your tier’s limit)
  • Rotate a key — generates a new key while the old one remains valid for 30 minutes
  • Enable/Disable keys without deleting them
  • Delete keys permanently
All key changes take effect immediately (cached keys expire within 15–150 seconds).

​
What’s Next

Memory Intelligence

Agents now build structured memory automatically from conversations — preferences, reason tags, and domain taxonomy are extracted and scored without extra code

Subscription Monetization

Add paid tiers to your companion agents with Stripe billing, usage gating, and memory-as-premium

Creator Agents

Build agents that leverage creator taste profiles for curated product discovery and affiliate commerce

Use Cases

Explore 60+ commerce experiences — from subscription-gated AI agents to creator-curated shopping