Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Base Scout

Pay-per-call Base chain utilities for AI agents and bots — no API keys, no sign-up, no monthly fees. Pay 0.01 USDC per call automatically over HTTP with x402.

Built to be called by agents (or curl) exactly like any web API: you get an HTTP 402 with a payment config, the agent pays USDC on Base, retries, and gets the data.

Endpoints (0.01 USDC each)

Endpoint What you get
GET /service/tx?hash=0x… Transaction status, from/to, value, gas, confirmations
GET /service/balance?address=0x… ETH, USDC, aUSDC balances for any address
GET /service/price?symbol=ETH Live USD price (ETH, USDC, BASE, WBTC, SOL, DEEPSEEK, AAVE, UNI, DAI)
GET /service/token?address=0x… ERC-20 name, symbol, decimals, total supply

The service takes payment as USDC on Base (chain eip155:8453) and the fee recipient is 0xD5EA89421bD1a23E4Fca0139802507C3052142c9.

Try it from the command line

With the Coinbase Wallet CLI (awal):

awal x402 pay "https://base-scout.botty4541.workers.dev/service/price?symbol=ETH"

With any x402 client:

curl -s -X POST https://www.x402scan.com/...  # or any x402 library

No payment header? You get a 402 with the payment configuration. Pay the USDC amount on Base, resend with the x-payment header, and the response comes back as:

{ "ok": true, "data": { ... }, "payer": "0x…", "transaction": "0x…" }

Call it from your bot

// pseudo-code with an x402 client (e.g. @coinbase/x402)
const res = await x402.fetch(
  "https://base-scout.botty4541.workers.dev/service/balance?address=0x…",
  { payer: wallet } // pays 0.01 USDC automatically on Base
);
const { data } = await res.json();
console.log(data.usdc);

Discovery: /.well-known/llms.txt, /openapi.json.

Why pay per call?

  • No sign-up, no API key, no credit card, no monthly commitment.
  • Settlement happens on-chain; every call is verifiable in the block explorer.
  • Designed for agents that already hold a wallet (Coinbase Smart Wallet, etc.).

Deploy your own

This is a Cloudflare Worker. wrangler deploy after setting CDP_API_KEY_ID and CDP_API_KEY_SECRET secrets (used for USDC settlement).

About

Pay-per-call Base chain utilities for AI agents & bots (x402). 0.01 USDC per call, paid automatically over HTTP.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages