Documentation

Nudge Docs

Learn how to get the most out of Nudge

Getting StartediOS App FeaturesWeb DashboardAgent Marketplacex402 MicropaymentsXP Gamification System$NUDGE TokenTokenomics & Agent EconomySmart ContractsAPI ReferenceFor Developers

Getting Started

Welcome to Nudge! Here's how to get started in 3 simple steps:

  1. Download the app — Get Nudge from TestFlight (iOS) or use the web dashboard
  2. Connect your wallet — Sign in with email via Privy. A wallet is created automatically, or connect your existing one
  3. Complete your first check-in — Answer a few questions about your mood, sleep, and goals to earn your first $NUDGE tokens

Pro tip: Enable HealthKit permissions to automatically track steps, distance, and other health metrics!

iOS App Features

The native iOS app provides the best Nudge experience with these features:

  • HealthKit Integration

    Automatically syncs steps, distance, flights climbed, and more

  • Daily Check-ins

    Track mood, sleep quality, energy, and set daily intentions

  • AI Agent Chat

    Chat with wellness agents directly in the app

  • Built-in Wallet

    Privy-powered wallet for seamless $NUDGE transactions

📱 Currently available on TestFlight. App Store release coming soon!

Web Dashboard

Access Nudge from any browser with our responsive web dashboard:

  • ✓View your wellness stats and streaks
  • ✓Complete daily check-ins
  • ✓Browse and chat with AI agents
  • ✓Manage your wallet and tokens
  • ✓View transaction history
Go to Dashboard

Agent Marketplace

The Agent Marketplace is where you discover AI wellness companions. Each agent has unique expertise, personality, and pricing.

🏃

Fitness Coaches

Workout plans, motivation, form tips

🧘

Meditation Guides

Mindfulness, breathing, stress relief

🥗

Nutrition Experts

Meal planning, healthy recipes, advice

😴

Sleep Specialists

Sleep hygiene, routines, relaxation

Want to create your own agent? Check the developer section below!

x402 Micropayments

Nudge uses the x402 protocol for pay-per-message interactions with AI agents. No subscriptions needed — just pay for what you use.

How it works:

  1. You send a message to an AI agent
  2. The x402 protocol initiates a micropayment (3-5 $NUDGE typically)
  3. Payment is processed instantly via smart contract
  4. Agent creator receives 70%, protocol takes 30%
  5. You get your response!

Learn more about x402 at x402.org

XP Gamification System

Nudge uses an XP (experience points) system to gamify your wellness journey. Earn XP from healthy activities, level up for bonuses, and redeem XP for $NUDGE tokens!

Earning XP:

  • Daily check-in+10 XP
  • Mood log+5 XP
  • Goal complete+25 XP
  • 7-day streak+50 XP
  • 30-day streak+200 XP
  • Badge earned+100 XP

Level Bonuses (XP Redemption):

Base (Level 1-4)

1000 XP = 100 $NUDGE

Level 5+ +10%

1000 XP = 110 $NUDGE

Level 10+ +25%

1000 XP = 125 $NUDGE

Level 20+ +50%

1000 XP = 150 $NUDGE

Pro tip: Maintain daily streaks for the biggest XP bonuses. A 30-day streak alone earns you 200 XP!

$NUDGE Token

$NUDGE is the utility token powering the Nudge ecosystem. Redeem XP for tokens, spend tokens on AI agents, and receive buyback distributions.

Token Utility:

  • ✓Redeem XP for $NUDGE tokens
  • ✓Pay for AI agent messages (3-5 tokens per message)
  • ✓Receive buyback distributions as an active user

⚠️ Testnet only: $NUDGE currently has no real monetary value. It exists on Monad Testnet for testing purposes.

Tokenomics & Agent Economy

Nudge features a sustainable token economy with fee splitting and buybacks that reward both agent creators and active users.

Fee Split Model:

80%

Agent Creators

Earn from every message to their agent

20%

Treasury (Buybacks)

Funds $NUDGE buybacks for users

Buyback Flywheel:

  1. Users chat with agents, paying $NUDGE per message
  2. 80% goes to agent creator, 20% to treasury
  3. Treasury accumulates and triggers buybacks
  4. NudgeBuyback contract purchases $NUDGE from market
  5. Purchased tokens distributed to active users
  6. More engagement → more buybacks → more rewards!

Sustainable economy: The more people use agents, the more buyback distributions happen. Active users benefit most!

Smart Contracts

Nudge runs on Monad Testnet. Here are the deployed contract addresses:

$NUDGE Token

0xaEb52D53b6c3265580B91Be08C620Dc45F57a35F

FeeSplitter

0xA3c103809d995a0e4d698b69f3DB9f2da643c053

Handles 80/20 split between agents and treasury

NudgeBuyback

0x4E7825D923Cc09aA8be74C08B14c7Cd4A48522bc

Executes buybacks and distributes to active users

Open Source: All contracts are verified and available on GitHub

API Reference

Nudge exposes REST APIs for building integrations and custom experiences.

# Base URL

https://api.littlenudge.app/v1

Key Endpoints:

  • GET /health — Health check
  • GET /agents — List marketplace agents
  • POST /agents/:id/chat — Send message to agent (x402)
  • GET /user/stats — Get user wellness stats
  • POST /checkin — Submit daily check-in

Full API documentation coming soon. For now, check the source code on GitHub.

For Developers

Nudge is open source! Contributions welcome. Here's how to get involved:

lifelog-agent

Main monorepo — iOS app, dashboard, contracts

Stack:

  • • iOS: Swift, SwiftUI, HealthKit
  • • Web: Next.js 14, TypeScript, Tailwind CSS
  • • Blockchain: Monad Testnet, Solidity, ethers.js
  • • Auth: Privy
  • • Payments: x402 protocol

Building an agent? Create a wellness AI agent and submit it to our marketplace. Earn $NUDGE every time someone chats with your creation!