Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.anchorbrowser.io/llms.txt

Use this file to discover all available pages before exploring further.

Anchor Browser supports X402 cryptocurrency payments for browser sessions when you have insufficient credits. This allows you to pay for sessions using cryptocurrency wallets.

​
How It Works

  1. Attempt Session Creation: Try to create a browser session
  2. Credit Check: System checks if you have sufficient credits
  3. Payment Prompt: If Error 402 is returned, you’re prompted to connect a wallet
  4. Automatic Payment: Payment is processed automatically through your wallet
  5. Session Creation: Session is created immediately after successful payment

​
Using X402 Payments via API

​
Prerequisites

  1. Install Coinbase Wallet: Currently only Coinbase Wallet is supported
  2. Get Funds: Ensure your wallet has USDC on the Base mainnet network
  3. Set Up WalletConnect: Configure WalletConnect for wallet connection

​
API Usage Example

When you make a session creation request without sufficient credits, the system will:
  1. Return a 402 (Payment Required) status
  2. Include payment details in the response
  3. Your client can automatically handle the payment using X402
  4. Retry the request with payment headers
Here are examples using the x402 library with both Python and Node.js: 
import os, json, requests
from eth_account import Account
from x402.clients.requests import x402_requests
from anchorbrowser import Anchorbrowser

ENDPOINT = "https://api.anchorbrowser.io/v1/sessions"
BODY = {}

key = os.getenv("PRIVATE_KEY") or exit("Set PRIVATE_KEY=0x...")

# Try to create session normally first
try:
    anchor_client = Anchorbrowser(api_key=os.getenv("ANCHOR_API_KEY"))
    session = anchor_client.sessions.create()
    print(json.dumps(session.data, indent=2))
except Exception as e:
    # If we get a 402 error, handle payment
    if "402" in str(e):
        # Get payment details and process with x402
        pre = requests.post(ENDPOINT, json=BODY, timeout=30)
        price = int(pre.json()["accepts"][0]["maxAmountRequired"])
        
        res = x402_requests(Account.from_key(key)).post(ENDPOINT, json=BODY, timeout=60)
        print(json.dumps(res.json(), indent=2))
    else:
        raise e

​
Pricing

  • Price per Session: $0.50 USDC
  • Network: Base mainnet only
  • Payment Method: USDC via X402 protocol

​
Read More