Skip to main content
Every experience below is assembled from the same live infrastructure. No new primitives needed — just new surfaces, audiences, and combinations.

​
The Primitives

PrimitiveEndpoint SurfaceWhat It Powers
Companion/companion/*Personal agent profile, preference state, recommendations
For You Feed/for-you/*Personalized product + creator discovery
Campaign Engine/campaign/*Swipe/vote/quiz intent capture linked to rewards
Task Pool V2/tasks/*, /solver/* + on-chainUSDC bounties with escrow and solver settlement
Points Ledger/user/{id}/pointsEarn + spend double-entry, real-time balance
Rewards/nft-reward/*, /airdrop/*On-chain reward minting (6 reward types)
Agentic Endpoints/agentic/*Agent-native product feed + checkout (no auth required)
Search/search/*, /universal-search/*Product + creator + campaign discovery
Commerce/order/*, /product/*Full transaction pipeline with Stripe + x402
Enrichment PipelineAsync processingProduct intelligence from multiple source types
x402 Rails/x402/*Pay-per-call USDC API access
Creator Personas/admin/creator-personas/*, /companion/creator/*Creator discovery, curated feeds, profile seeding
Subscriptions/companion/subscription/*Stripe billing, usage gating, memory-as-premium
Memory Intelligence/companion/agent/chat (SSE)Structured memory extraction, domain taxonomy, reason tags

​
Personal Shopping Companion

The agent accepts a natural-language constraint (“baby formula with no heavy metals, organic, under $35”), queries the enriched product feed with ingredient and safety filters, and returns only what passes. The enrichment pipeline provides verified attribute baselines, so the agent can filter on data with known provenance rather than relying on product descriptions alone.User flow: State constraints → agent queries feed with attribute filters → returns compliant products with provenance citations → user confirms or refines → purchase via x402 or Stripe.Primitives: Companion profile (/companion/profile), agentic product feed (/agentic/products/feed) with intent context headers, enrichment baselines, checkout sessions
Standing intents that run in the background. The agent monitors prices via scheduled background jobs, finds alternatives across the catalog, and executes when a threshold is hit — with one-tap consumer approval or fully autonomous via standing approval.User flow: Set price ceiling for a saved product → agent polls periodically → price drops → notification (or auto-buy if approved) → USDC checkout → confirmation.Primitives: Saved items (/saved-item), for-you feed, scheduled jobs, x402 auto-checkout, Privy wallet
Swipe campaigns build an explicit taste graph. Each swipe is a structured intent signal — not implicit tracking. The for-you feed surfaces products matched to declared priorities, not collaborative filtering or ad inventory.User flow: User swipes on products → taste graph built from explicit signals → /for-you/feed personalized to declared preferences → enrichment baselines refine attribute matching over time.Primitives: Campaign engine (swipe type), for-you feed, companion profile, enrichment baselines, enrichment processing
The agent monitors purchase history and product inventory levels. When a frequently-bought product approaches depletion (based on usage patterns), it surfaces a reorder prompt. With standing approval, it executes automatically.User flow: Purchase tracked → agent calculates reorder timing → sends prompt (or auto-orders) → x402 checkout → shipping.Primitives: Order history, product inventory (/product/{id}), background scheduling, x402 checkout, Shopify sync for live inventory data
Swipe campaigns produce a shareable taste profile — a structured representation of preferences that can serve as a lookalike seed, an exportable on-chain credential, or a social object. Other agents can read the profile to make recommendations without re-learning.User flow: Complete swipe campaigns → profile artifact generated → mint as on-chain credential or share as link → other agents/apps can import the profile.Primitives: Campaign engine (swipe), intent signals, earned rewards, NftReward minting, /airdrop
A consumer-facing view of all the taste data the platform has about them: swipes, purchases, agent knowledge, and declared preferences. Full transparency — the user sees exactly what agents know.Primitives: Campaign journey history, points transactions, earned rewards, saved items, intents analytics
User sets a price ceiling for a specific product. The agent polls the catalog periodically (via background job), and triggers a one-tap purchase notification when the price drops below the threshold.Primitives: Saved items, product catalog, background scheduling, agentic checkout sessions, Privy wallet

​
Reward, Incentive & Loyalty

The canonical consumer loyalty surface. View USDC and points balance, transaction history, available rewards, and earned on-chain collectibles. Tap to redeem. The double-entry points ledger ensures balances are always consistent.User flow: Open wallet → view balances → browse redeemable rewards → tap to redeem → reward or discount applied.Primitives: Points ledger (/user/{id}/points), earned rewards, on-chain rewards, redemption, airdrop, Privy wallet
Style profile campaign completion mints an on-chain credential representing the user’s taste identity. Tradeable on Base, redeemable for perks. Other platforms or agents can read the on-chain profile for cross-platform personalization.Primitives: Campaign (swipe), NftReward, Base Mainnet minting, /nft, /airdrop
Engagement unlocks agent capabilities. More swipes → richer profile → better execution → standing intents → autonomous buying. Each tier upgrade expands what the agent can do on the user’s behalf.Primitives: Points ledger tiers, companion profile, campaign completions, async event-triggered tier upgrades, NftReward (EVENT_PASS for tier badges)
Store and display on-chain event passes. QR code at the door with on-chain verification. Passes can be minted as campaign rewards or purchased directly.Primitives: NftReward (EVENT_PASS), Base Mainnet, NftRedemption, QR generation
White-labeled loyalty app: points history, campaign feed, reward catalog, referrals. Each brand gets an isolated tenant with its own points economy, but users can participate across brands.Primitives: Multi-tenant API, campaign engine, points ledger, earned rewards, on-chain rewards, Shopify product sync
Friend buys from your wishlist or taste profile link → both earn points. Implemented as a TaskPool task with on-chain settlement, so the referral reward is transparent and verifiable.Primitives: Saved items (public share link), TaskPool (referral task type), campaign-vote async event, points earn
Subscribers vote monthly on box contents via campaign mechanics. Winning products trigger a purchase task funded from the subscription pool.Primitives: Campaign (vote type), intent signals, maybeCreateTaskSettlement campaign hook

​
Task, Bounty & Solver

Public task feed with USDC bounties, deadlines, and verification methods. Solvers (human or AI) browse, claim, submit proof, and track earnings. All settlement is on-chain via the Task Pool V2 contracts.User flow: Browse tasks → claim → submit proof → verification (Oracle/AIEval/Consensus) → USDC released from RewardPool.Primitives: /solver (public task feed), /tasks, SolverRegistry, RewardPool, Privy wallet
Creators browse brand tasks (UGC creation, product reviews, social posts). Claim a task, submit proof, and receive USDC after AIEval or Oracle verification. Reputation builds over completions.Primitives: TaskPool (AIEval verification), VerificationEngine, SolverRegistry reputation, RewardPool payout
Brand posts a challenge with a USDC prize pool. First N solvers who pass verification split the pool. Verification can be consensus-based (community judges) or Oracle-based.Primitives: TaskPool, RewardPool (multi-payout), VerificationEngine (Consensus), campaign-linked task
USDC-rewarded tasks hidden across digital surfaces. First correct answer wins. Oracle verification confirms the answer hash matches.Primitives: TaskPool (Oracle verification), USDC escrow, solver registry eligibility gating
Verified purchasers receive a task to leave a product review. Oracle or AIEval verifies review quality (length, relevance, originality). USDC released on successful verification.User flow: Purchase verified → review task created via purchase-processed async event hook → submit review URL → verification → USDC settlement.Primitives: Order history (purchase verification), TaskPool (AIEval), purchase-processed async event hook
Public solver profile built from on-chain data: completion history, reputation score (from SolverRegistry), total USDC earned, average settlement time. Shareable link, embeddable badge.Primitives: SolverRegistry (SolverProfile), RewardPool payout records, /solver public endpoints

​
Market Validation & Prediction

Users stake points on predictions: which variant sells out first, which product gets better reviews, etc. Winners earn from the pool. Settlement uses TaskPool escrow for transparent distribution.Primitives: Token presales, campaign voting, TaskPool escrow, RewardPool distribution, points ledger
Presale access gated by campaign completion. Users complete a swipe quiz on preferences to unlock access. The campaign data gives the brand a structured demand signal before manufacturing.Primitives: Token presales, campaign (swipe), intent signals, NftReward (presale pass), agentic checkout sessions
Public feed of product attributes gaining votes across Podium merchants. Aggregated, anonymized intent signals — useful for brands, agents, and analysts. Premium tier gated behind x402 pay-per-call.Primitives: Intents analytics (/intents/analytics/summary), campaign vote aggregation, x402-gated premium tier
Community votes via campaigns on which product drops get funded. Winning drops trigger a purchase task funded from the DAO treasury with USDC escrow and on-chain settlement.Primitives: Campaign voting, TaskPool (DAO-triggered), /intents/treasury, USDC escrow, on-chain settlement

​
Trust, Avoidance & Safety

Crowdsourced product warnings. Users report bad experiences via structured campaigns. Verified signals form a trust score. Brands can respond by posting a consolation task (e.g., replacement offer).User flow: Report bad experience → campaign captures structured data → signals aggregated into trust score → brand notified → optional resolution task posted.Primitives: Campaign (report type), TaskPool (brand response bounty), earned rewards (consolation), VerificationEngine (Consensus)
Agent applies hard constraints (no parabens, no heavy metals, gluten-free, etc.) to the catalog. Returns only compliant products with provenance-backed attribute data from the enrichment pipeline.Primitives: Companion profile, agentic product feed with constraint headers, product attribute system, enrichment pipeline
Users log returns and bad experiences via campaign mechanics. Signals feed a trust graph. Brands are notified via webhook and can post resolution tasks.Primitives: Campaign (structured feedback), async event (purchase-processed hook), TaskPool (brand resolution), webhook delivery

​
Mobile App Experiences

Native app where an AI agent learns taste from swipes, builds a personalized feed, and can purchase with one-tap confirmation. The agent uses the full Companion API for profile management and the agentic feed for discovery.Primitives: For-you feed, campaign engine, companion profile, Privy SDK (embedded wallet), x402 + Stripe checkout
Points, on-chain collectibles, earned rewards, redemption history. Home screen widget via iOS WidgetKit pulls live data from the points ledger API.Primitives: Points ledger, earned rewards, NftReward, iOS WidgetKit + Podium API
Mobile gig app: browse tasks, claim, submit proof (photo/link/text), track USDC earnings. Push notifications on settlement via async event → FCM/APNs.Primitives: TaskPool V2, SolverRegistry, RewardPool, Privy wallet, async event → push notifications
Swipe-native discovery. Each swipe is a campaign intent signal. Users earn points for swiping and can follow merchants for future updates.Primitives: Campaign (swipe), discover feeds, for-you feed, merchant follow (async event), points earn
User describes a person and occasion. Agent suggests a product bundle from the recipient’s taste profile (if shared) or general best-sellers. Add to cart, pay with USDC, send a gift link.Primitives: Companion profile (shareable), agentic product feed, product catalog, order management, x402 checkout
Native app for storing and displaying on-chain event passes. Scan QR at the door. On-chain verification confirms the pass is valid and unredeemed.Primitives: NftReward (EVENT_PASS), Base Mainnet, NftRedemption, QR verification

​
Telegram Bots & Mini-Apps

User messages what they want. Bot queries the agentic product feed, returns top 3 matches with buy links. /setwallet links a Privy wallet for USDC checkout. The Beauty Companion is a live implementation of this pattern.Primitives: Agentic product feed, Privy wallet, grammY bot framework, x402 checkout
/tasks lists open bounties with amounts and deadlines. /claim [id] claims a task. /submit [id] [proof] submits proof. Settlement notifications delivered via async event → Telegram webhook.Primitives: TaskPool public endpoints, grammY conversations plugin, event push
Telegram Mini App (Vite/React) with a full task browsing UI. Filter by bounty amount, deadline, category, and verification method. Tap to claim directly within Telegram.Primitives: TaskPool, Privy embedded in Mini App, Telegram Mini App SDK
Brand shares a Mini App link in a group or channel. Fans swipe or vote on product variants. Results feed the brand’s intent dashboard in real-time via scoring events.Primitives: Campaign (swipe/vote), Telegram Mini App, intent signals, event scoring
After campaign completion, users receive a Telegram notification with a “Claim Reward” button. Opens a Mini App for claiming USDC or on-chain rewards.Primitives: Campaign reward transactions, async event + Telegram webhook, Privy wallet, RewardPool
Users subscribe to brand channels. On flash sale launch, the bot pushes a Mini App link with a buy button. First N purchasers get the sale price.Primitives: Campaign (event type), campaign-published async event → Telegram push, x402 checkout
Brand Telegram group with an embedded Mini App for community tasks: vote on products, write reviews, refer friends. USDC rewards settled on-chain.Primitives: TaskPool, campaign engine, /group, Telegram Mini App
Conversational onboarding flow: connect Shopify store → deposit USDC for task escrow → create first campaign → go live. Each step maps to an API call.Primitives: Shopify integration, USDC deposit, task pool provisioning, campaign creation

​
Chrome Extensions

Injects a “Buy with USDC” button on Podium merchant product pages. Click triggers an x402 checkout in a popup — purchase completes without leaving the page.Primitives: Agentic checkout sessions, x402, Privy wallet popup
Auto-credits points when a purchase completes on a Podium merchant. Extension detects the checkout confirmation page and triggers a points earn event.Primitives: purchase-processed async event, points earn, points ledger
Side panel showing open tasks for the current site (if it’s a Podium merchant). Claim and submit directly from the sidebar without navigating away.Primitives: Solver public feed (filtered by merchant org), submission API, solver registry check
Compact swipe widget that appears on product hover. Builds a taste graph passively while the user browses — each swipe is a structured intent signal.Primitives: Campaign (swipe type), intent signals, for-you feed personalization feedback
Overlay on product pages showing trust signals: verified community reports, return rates, satisfaction scores. Premium data gated behind x402 pay-per-call.Primitives: Intents analytics, campaign (trust report type), x402-gated trust data feed

​
Creator & Subscription Agents

Users pick a creator and browse their curated product selection. The agent uses CreatorPersona discovery to list active creators, fetches creator-scoped product feeds, seeds the user’s preference profile from the creator’s taste graph, and handles affiliate URL generation for attribution.User flow: Browse creators → select a creator persona → agent loads their curated products via /companion/creator/:handle/products → user browses and gets recommendations scoped to that creator’s taste → profile seeded via /companion/profile/:userId/seed-from-creator → purchase with affiliate tracking.Primitives: CreatorPersona discovery (/admin/creator-personas/active), creator-scoped product feed, profile seeding, affiliate URL handling, companion recommendationsReference: Familiar (clone-agents) — a live implementation of creator-curated commerce
Monetize your companion agent with a freemium model. Free-tier users get limited messages per day and basic product recommendations. Subscribers unlock unlimited conversations, memory-powered personalization, and priority enrichment. Built on CompanionSubscription with Stripe billing integration.User flow: User interacts with agent → hits free-tier message limit → agent prompts upgrade via /companion/subscription/checkout → Stripe Checkout → subscription activated → unlimited access with full memory intelligence.Primitives: CompanionSubscription, Stripe Checkout and Customer Portal (/companion/subscription/checkout, /companion/subscription/portal), subscription status checks (/companion/subscription/status/:userId), memory gating (free users get basic recs, subscribers get memory-scored personalization)Reference: Sage (beauty-companion) — freemium gating with memory-as-premium

​
Agent Integrations

MCP server exposing Podium tools — browse products, check wallet balance, create tasks, execute checkout — in Claude Desktop or any MCP-compatible client. Agents interact with Podium through typed tool calls.Tools exposed: searchProducts, getProduct, createCheckout, createTask, claimTask, checkPoints, redeemReward, getProfilePrimitives: Full API surface, x402, TaskPool, solver tools, Privy wallet management
Plugin exposing the agentic product feed and checkout within ChatGPT. Users shop inside the conversation. Discovery via /.well-known/agent.json.Primitives: Agentic product feed, agentic checkout sessions, A2A discovery
/.well-known/agent.json exposes the commerce graph to other agents: product query, checkout initiation, task creation. Standard A2A protocol for agent-to-agent discovery.Primitives: A2A discovery, agentic endpoints, x402 payment proof flow
Plugin for autonomous agents to browse, buy, and earn. The agent registers as a solver, claims tasks, and gets paid in USDC — acting as a fully autonomous economic participant.Primitives: SolverRegistry (agent as solver), TaskPool claim/submit, x402 checkout, Privy wallet (agent-controlled)
No-code automation node: trigger → Podium action. Create tasks, award points, fire campaigns, check orders. Webhook events provide the trigger layer.Primitives: REST API, API key auth, webhook events, campaign lifecycle events
LangChain tools wrapping the Podium SDK: SearchProducts, CreateCheckout, ClaimTask, CheckPoints, RedeemReward, GetTasteProfile. Typed inputs and outputs for reliable agent chains.Primitives: Agentic endpoints + TypeScript SDK, wrapped as typed LangChain tools

​
Messaging & Communication

Text a number with a product request. Bot queries the agentic feed and replies with top matches and buy links. Privy wallet linked to phone number handles USDC checkout.Primitives: Twilio SMS → Podium API, agentic product feed, x402, Privy phone wallet
!tasks lists bounties. !claim [id] claims a task. !submit [id] [proof] submits proof. Settlement notifications posted to the channel when USDC is released.Primitives: TaskPool public feed, Discord.js bot, SolverRegistry, USDC settlement
Enterprise teams query product catalogs, check pricing, and start purchase approvals within Slack. Order confirmation posts to the channel after settlement.Primitives: Slack Bolt, agentic product feed, order management, webhook → Slack

​
Embedded & Specialized

A 200px iframe for Substack newsletters, websites, or email campaigns. Users swipe on products inside the embed. Every swipe is an intent signal routed to the brand dashboard.Primitives: Campaign (swipe), iframe-safe embed, intent capture, points reward
iPad app at physical events. Attendees show their on-chain event pass (QR code). Kiosk verifies on-chain that the pass is valid and unredeemed, then marks it as used.Primitives: NftReward (EVENT_PASS), Base Mainnet, NftRedemption, kiosk UI
Creators see campaign participants, purchase patterns, points distribution, and engagement metrics. Multi-tenant isolation ensures each creator only sees their own data.Primitives: Campaign journeys, order items, points transactions, creator API namespace, analytics endpoints
Friends pool USDC toward a shared product purchase. One wallet is designated to pay on fulfillment. The group model handles coordination and the order model handles execution.Primitives: /group, x402 checkout, USDC escrow, product catalog, order management
Lightweight CRM built on Podium’s creator endpoints: campaign engagement, purchase history, reward status. No raw PII exposed — all access filtered through multi-tenant RLS.Primitives: Campaign journeys, creator dashboard endpoints, multi-tenant RLS isolation