Skip to main content

Reward Agent Examples

Real-world examples of AI assistants using the Reward Agent.

Example 1: Discover Brands by Category​

You: "What retail brands are on the Resonance network?"

AI calls: rsnc_agent_list_brands with category: "retail"

AI responds: Lists all retail brands with their reward programs, including event types, reward amounts, and available perks.

Example 2: Compare Brand Programs​

You: "Compare Brand A and Brand B — which one has a better rewards program?"

AI calls: rsnc_agent_compare_brands with both brand IDs

AI responds: Side-by-side comparison showing:

  • Events per day (velocity)
  • Customers reached
  • Total rewards distributed
  • Event diversity
  • Active perks
  • Per-metric winners and insights

Example 3: Check Brand Health​

You: "How healthy is brand 0xABC's reward program?"

AI calls: rsnc_agent_brand_health with the brand ID

AI responds: Health score (0-100), letter grade, breakdown by:

  • Event diversity
  • Claim activity
  • Perk availability
  • Customer growth

Plus strengths, weaknesses, and actionable recommendations.

Example 4: Browse Perks Under Budget​

You: "Show me perks I can get for under 5000 RSNC"

AI calls: rsnc_agent_browse_perks with maxPrice: 5000

AI responds: List of affordable perks across all brands with costs and descriptions.

Example 5: Process a Reward (Authenticated)​

You: "Record a purchase event for [email protected] at brand 0xABC"

AI calls: rsnc_agent_process_event with:

{
  "brandId": "0xABC...",
  "eventType": "purchase",
  "userId": "[email protected]",
  "metadata": { "order_total": 50 }
}

AI responds: Confirmation with the RSNC reward amount credited.

Example 6: Check User Balance (Authenticated)​

You: "How much RSNC does [email protected] have at brand 0xABC?"

AI calls: rsnc_agent_user_balance with user and brand IDs

AI responds: Current balance, total earned, total redeemed, and available to spend.

Example 7: Onboard a New Brand (Authenticated + canOnboard)​

You: "Register Acme Corp on the Resonance network. Their wallet is 0xDEF..., contact is [email protected]"

AI calls: rsnc_agent_onboard_brand with:

{
  "brandAddress": "0xDEF...",
  "businessName": "Acme Corp",
  "contactEmail": "[email protected]",
  "website": "https://acme.com",
  "category": "retail"
}

AI responds: Registration confirmation, portal URL, and next steps.

Example 8: Create Events for a Brand (Authenticated + canManageProgram)​

You: "Set up a purchase event for brand 0xABC that gives 10 RSNC per claim with 24-hour cooldown"

AI calls: rsnc_agent_create_event with:

{
  "brandId": "0xABC...",
  "eventType": "purchase",
  "rewardAmount": 10,
  "cooldownHours": 24
}

AI responds: Event created with ID and configuration details.

Example 9: Route a Purchase for Maximum Rewards​

You: "I want to buy running shoes for about $150. Which brand gives me the best cashback?"

AI calls: rsnc_agent_route_purchase with:

{
  "intent": "running shoes",
  "category": "retail",
  "purchaseAmount": 150
}

AI responds: Ranked list of matching brands sorted by total reward value — cashback earned, redeemable perks, and effective savings percentage.

Example 10: Compare Cashback Across Brands​

You: "If I spend $100, how much cashback do I get at Brand A vs Brand B vs Brand C?"

AI calls: rsnc_agent_compare_cashback with:

{
  "brandIds": ["0xAAA...", "0xBBB...", "0xCCC..."],
  "purchaseAmount": 100
}

AI responds: Side-by-side cashback amounts at each brand — e.g., "$8 back at Brand A vs $3 back at Brand B vs $5 back at Brand C" — with a clear winner.

Example 11: Find the Best Deals​

You: "What are the best coffee deals on the network right now?"

AI calls: rsnc_agent_best_deals with:

{
  "intent": "coffee",
  "limit": 5
}

AI responds: Top 5 deals matching "coffee" ranked by reward value, including cashback rates and available perks at each brand.

Example 12: Stack Deals for Maximum Savings (Authenticated)​

You: "I'm buying $75 worth of coffee at brand 0xABC. What's the best deal I can get?"

AI calls: rsnc_agent_stack_deals with:

{
  "brandId": "0xABC...",
  "purchaseAmount": 75,
  "userId": "[email protected]"
}

AI responds: Optimal deal stack showing base cashback + best redeemable perk + streak multiplier bonus, with total savings breakdown and any discount codes.

Example 13: View Cross-Brand Portfolio (Authenticated)​

You: "Show me all my rewards across every brand"

AI calls: rsnc_agent_user_portfolio with:

{
  "userId": "[email protected]"
}

AI responds: Unified portfolio — total balance, per-brand breakdown, active streaks, and the best perk affordable right now.

Example 14: Next Goal Nudge (Authenticated)​

You: "What's the fastest way for me to earn my next reward at brand 0xABC?"

AI calls: rsnc_agent_next_goal with:

{
  "userId": "[email protected]",
  "brandId": "0xABC..."
}

AI responds: Exactly how many actions (purchases, reviews, referrals) are needed to afford the most attainable perk, creating urgency and a clear path forward.

Example 15: Estimate ROI for a Business​

You: "I run a restaurant with 2000 monthly customers averaging $35 per visit. Is a loyalty program worth it?"

AI calls: rsnc_agent_estimate_roi with:

{
  "industry": "dining",
  "monthlyCustomers": 2000,
  "averageOrderValue": 35
}

AI responds: Industry benchmarks, projected impact on retention and revenue, ROI multiplier, and recommended next steps.

Example 16: Network Overview​

You: "Give me a full health report on the Resonance network"

AI uses prompt: network_overview

AI calls: rsnc_agent_network_info → rsnc_agent_network_stats → rsnc_agent_network_analytics

AI responds: Network identity, scale and reach, growth trends, category breakdown, and outlook.

Using Prompts​

The agent includes 6 built-in prompts that chain multiple tools together:

PromptWhat It Does
analyze_brandDeep dive into one brand's program (6 API calls)
explore_categoryCategory landscape with top performers
user_activityUser reward profile with recommendations
setup_brandEnd-to-end brand onboarding workflow
network_overviewFull network health report
compare_brandsMulti-brand comparison matrix

To use a prompt, simply describe what you need. Your AI assistant will recognize the pattern and invoke the appropriate prompt workflow.

Example 17: User Persona (Authenticated)​

You: "What kind of customer is [email protected]?"

AI calls: rsnc_agent_user_persona with:

{
  "userId": "[email protected]"
}

AI responds: Persona archetype (e.g., "deal_hunter"), earn patterns, brand affinities, price sensitivity, and network position.

Example 18: Personalized Recommendations (Authenticated)​

You: "What perks should I recommend to [email protected]?"

AI calls: rsnc_agent_user_recommendations with:

{
  "userId": "[email protected]",
  "limit": 5
}

AI responds: Ranked list of perks scored by persona affinity and affordability, with reasoning for each.

Example 19: Perk Intelligence​

You: "How are our perks performing at brand 0xABC?"

AI calls: rsnc_agent_perk_intelligence with brandId: "0xABC..."

AI responds: Per-perk heat scores, conversion rates, supply depletion projections, and optimization recommendations.

Example 20: Network Flows​

You: "How are users flowing between brands?"

AI calls: rsnc_agent_network_flows with period: "30d"

AI responds: Emitter vs attractor brands, category-level movement patterns, and cross-brand engagement insights.

Example 21: AI Event Suggestions​

You: "What reward events should brand 0xABC set up?"

AI calls: rsnc_agent_suggest_events with brandId: "0xABC..."

AI responds: Recommended event types, reward amounts, and cooldown periods based on network-wide patterns for the brand's category.

REST API Examples​

Use curl or any HTTP client — no MCP required.

Browse brands​

curl "https://agent.rsnc.network/api/v1/brands?category=retail&limit=5"

Get brand details​

curl https://agent.rsnc.network/api/v1/brands/0xABC123

Compare cashback​

curl "https://agent.rsnc.network/api/v1/compare/cashback?category=retail&purchaseAmount=100"

Route a purchase​

curl "https://agent.rsnc.network/api/v1/commerce/route?intent=running+shoes&purchaseAmount=150"

Process a reward (authenticated)​

curl -X POST https://agent.rsnc.network/api/v1/events \
  -H "Content-Type: application/json" \
  -H "X-RSNC-Agent-Key: your-key-id" \
  -H "X-RSNC-Timestamp: 1709500000" \
  -H "X-RSNC-Signature: <computed>" \
  -d '{"brandId":"0xABC","eventType":"purchase","userId":"[email protected]"}'

See REST API Reference for all 45 endpoints.

CLI Examples​

Explore the network​

rsnc network info
rsnc network brands --category retail --limit 5
rsnc network check nike.com

Analyze a brand​

rsnc brand info 0xABC123
rsnc analytics health 0xABC123
rsnc brand leaderboard 0xABC123 --metric rsnc_earned --period monthly

Route purchases​

rsnc commerce route "running shoes" --purchaseAmount 150
rsnc commerce compare-cashback --purchase-amount 100 --category retail

Get AI suggestions​

rsnc netintel suggest-events 0xABC123
rsnc netintel suggest-perks 0xABC123
rsnc netintel trending --period 7d

Process rewards​

rsnc rewards track --brandId 0xABC --eventType purchase --userId [email protected]
rsnc user balance [email protected] 0xABC

See CLI Reference for all commands.

Converse Examples​

Natural language queries via the Converse endpoint.

# Via curl
curl -X POST https://agent.rsnc.network/converse \
  -H "Content-Type: application/json" \
  -H "X-RSNC-Agent-Key: your-key-id" \
  -H "X-RSNC-Timestamp: $(date +%s)" \
  -H "X-RSNC-Signature: <computed>" \
  -d '{"query": "What are the best coffee deals on the network?"}'

# Via CLI
rsnc converse "Which brand gives the best cashback for a $100 retail purchase?"
rsnc converse "How healthy is my reward program?" --context '{"brandId":"0xABC"}'

See Converse for full documentation.

Last updated on