Pricing

import os
from x402 import x402Client
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import register_exact_evm_client
from x402.http.clients import x402HttpxClient
from eth_account import Account

# Setup wallet
account = Account.from_key(os.environ["WALLET_KEY"])

# Create x402 client
client = x402Client()
register_exact_evm_client(client, EthAccountSigner(account))

# Call any premium endpoint — payment handled automatically
async with x402HttpxClient(client) as http:
    res = await http.get("https://ipfast.dev/json/8.8.8.8")
    data = res.json()
    print(data["country"], data["city"])

package main

import (
    "encoding/json"
    "fmt"
    "net/http"

    x402 "github.com/coinbase/x402/go"
    "github.com/coinbase/x402/go/evm"
)

func main() {
    // Create x402 client with wallet
    client := x402.Newx402Client()
    client.Register("eip155:*", evm.NewExactEvmScheme(privateKey))
    httpClient := x402.WrapHTTPClientWithPayment(
        http.DefaultClient, client,
    )

    // Call any premium endpoint — payment handled automatically
    resp, _ := httpClient.Get(
        "https://ipfast.dev/json/8.8.8.8",
    )
    defer resp.Body.Close()

    var data map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&data)
    fmt.Println(data["country"], data["city"])
}

# Option 1: Use an API key (simplest, no wallet needed)
curl -H "X-API-Key: sk_live_your_key_here"      https://ipfast.dev/json/8.8.8.8

# Option 2: Pay per request with x402
# Step 1 — Get payment requirements:
curl -s https://ipfast.dev/json/8.8.8.8
# Returns 402 with price, wallet, and network details

# Step 2 — Sign payment with x402 SDK and retry:
curl -H "X-PAYMENT: <base64-signed-payload>"      https://ipfast.dev/json/8.8.8.8

# Free endpoints (free API key required -- register at ipfast.dev/login):
curl https://ipfast.dev/json        # Your own IP
curl https://ipfast.dev/country     # Your country code
curl https://ipfast.dev/city        # Your city