Quick Start

Make your first autonomous payment in 5 minutes. This guide walks you through connecting a wallet, setting spending limits, and requesting your first x402 service.

What You'll Accomplish

By the end of this guide, you will:

• Make your first autonomous payment request

• Observe Miko settle a transaction on-chain

• Understand the x402 payment flow

• Configure initial spending limits

Prerequisites

• A Web3 wallet (Phantom, MetaMask, or Coinbase Wallet)

• Some cryptocurrency (SOL, ETH, or any x402-compatible token)

• 5 minutes

New to wallets? Get Phantom for native Solana support—setup takes about 2 minutes.

Step 1: Launch Miko

Visit miko402.xyz and click "Launch App."

You'll see a clean chat interface. No registration or login required.

Step 2: Start a Conversation

Type a simple request:

What x402 services can you access?

Miko will respond with available APIs, current pricing, and service categories. This demonstrates natural language understanding without requiring any structured commands.

Step 3: Connect Your Wallet

Click "Connect Wallet" in the top-right corner and select your provider:

• Phantom — Native Solana support

• MetaMask — Most widely used

• Coinbase Wallet — Beginner-friendly

• WalletConnect — Mobile wallet support

Approve the connection. Your wallet address will appear in the interface.

Important: Use a dedicated wallet for autonomous payments. Never risk more than you can afford to lose.

Step 4: Make Your First Payment

Request a paid service:

Get weather data for San Francisco

Observe the payment flow:

1. Service Discovery — Miko identifies the appropriate x402 service

2. HTTP 402 Detected — Payment Required response received with pricing

3. Limit Verification — Spending limits checked against your configuration

4. Payment Approval — Click "Approve & Pay"

5. Settlement — Transaction signed and broadcast to the blockchain

6. Delivery — Payment confirmed (~2 seconds on Solana), data delivered

Step 5: Set Spending Limits

Before making additional payments, configure your spending limits.

Recommended starting limits:

Period	Amount	Approximate USD
Daily	0.01 SOL	~$2.50
Weekly	0.05 SOL	~$12.50
Monthly	0.2 SOL	~$50

Spending limits are configured in .env.local and enforced by smart contracts on-chain. Miko will automatically reject any payment that would exceed your caps.

Start conservative and increase limits as you become familiar with typical service costs.

Understanding the Flow

Here's what happens during an autonomous payment:

You Request → API Returns HTTP 402 → Miko Verifies Limits →
You Approve → Blockchain Confirms → Service Delivers Data

Total elapsed time: 3–5 seconds on Solana.

Compare this with traditional API access:

Sign Up → Verify Email → Add Payment Method → Subscribe →
Wait for Approval → Access Service

Example Requests

Weather Data

Get 7-day forecast for New York from OpenWeather

✓ Service: OpenWeather Premium
✓ Cost: 0.001 SOL
✓ Confirmed in 2.1 seconds
✓ Forecast data delivered

AI Image Generation

Generate an image of a sunset over mountains

✓ Service: Heurist Mesh
✓ Cost: 0.002 SOL
✓ Payment confirmed
✓ Image generated and displayed

IPFS Storage

Pin my document to IPFS

✓ Service: Pinata
✓ Cost: 0.001 SOL
✓ Payment confirmed
✓ IPFS Hash: Qm...

Tips for Getting Started

Be Specific

• ❌ "Get me some data"

• ✅ "Get weather data for London from WeatherAPI"

Start Small

• ❌ Set a 10 SOL daily limit on day one

• ✅ Start with 0.01 SOL and increase gradually

Monitor Transactions

• Check transaction hashes on block explorers

• Review spending against your configured limits

• Verify services before committing to larger payments

Estimate Costs First

Ask Miko: "How much would it cost to...?" before committing to a payment.

Safety Guidelines

1. Set spending limits before making payments

2. Verify services — only use x402 providers listed in the registry

3. Test with small amounts before scaling up

4. Monitor spending — review transaction history regularly

5. Secure your wallet — use hardware wallets for significant holdings

Red flags to watch for:

• Services requesting private keys

• Unverified providers with unusually low pricing

• Services with no documentation

• Unusual blockchain fee amounts

Common Questions

Is there a platform fee? No. Miko402 charges 0% platform fees. You pay only blockchain gas and service costs.

What if a payment fails? Your funds revert automatically. Blockchain transactions are atomic—either they complete fully or not at all.

Can I cancel a pending payment? Once submitted on-chain, transactions cannot be cancelled. Spending limits serve as your primary protection.

Which blockchains are supported? Solana, Ethereum, Polygon, Base, and any x402-compatible chain.

Are conversations stored? No. Conversations exist only in your browser session and are cleared on refresh.

Next Steps

Learn the fundamentals:

• Installation Guide — Complete local setup

• Configuration — Advanced spending limit and wallet configuration

• Using the Chat — Advanced interaction techniques

Go deeper:

• How Miko Works — Architecture overview

• Security Features — How your funds are protected

• FAQ — Comprehensive answers

Get help:

• Troubleshooting — Common issues and solutions

• Support — Direct assistance

---

Ready for the full setup? Continue to the Installation Guide for local deployment.