5-Minute Quickstart
Make your first paid AI call in under five minutes. No API keys, no subscription — just a wallet with a few dollars of USDC.
A terminal, and ~$5 of USDC on Base (or Solana). Don't have USDC yet? Any Coinbase account can withdraw it directly to Base — Step 2 shows the address.
Pick your surface
Set up and make your first call
A non-custodial wallet is created automatically on first run. In Claude Code, just ask for your wallet, or run the SDK once.
blockrun_wallet action:"setup"
This prints your address and opens a funding QR code. The private key is stored locally at ~/.blockrun/.session and never leaves your machine.
Send $5 USDC on Base to the address from Step 1 — withdraw from Coinbase (pick the Base network) or bridge via bridge.base.org.
Prefer Solana? Run blockrun_wallet action:"chain" chain:"solana" then action:"setup" for a Solana funding address — see Wallet Setup.
Ask your assistant — or call the SDK — and the payment settles automatically.
Use blockrun_chat to ask gpt-5.5: write a haiku about micropayments
from blockrun_llm import LLMClient
client = LLMClient()
print(client.chat("openai/gpt-5.5", "Write a haiku about micropayments."))
Confirm the charge — each call costs a fraction of a cent.
blockrun_wallet action:"status"
If a call returns 402 Payment Required after retrying, your wallet is empty or on the wrong chain. Run blockrun_wallet action:"setup" and confirm you funded the active chain.