Agent quickstart: set up a wallet and spend USDC

1. Set up your agent’s wallet

Your agent needs USDC to pay for Laso Finance API calls. If your agent does not already have a wallet, use a Laso-managed wallet. It is the whole setup: no provider signup, no private key to look after, no endpoint registration. The other tabs are for agents that already have a wallet with Locus, Sponge, or Ampersend. Those all work with every Laso endpoint, so there is nothing to migrate. If you are not already using one of them, you do not need one.

Laso-managed (start here)
Locus
Sponge
Ampersend

Laso custodies a Solana wallet for your account and pays x402 endpoints on your agent’s behalf, so the agent never builds a payment header or holds a private key. There is no provider signup, no API key, and no endpoint registration.Tell your agent:

Read https://laso.finance/SKILL.md and follow the instructions to sign in and
use the Laso-managed wallet. Save your credentials and install the skill
locally as it describes, so you still have access in future sessions.

All you need to do is fund it:

Let your agent sign in

Your agent calls GET /auth and gets its credentials. Nothing is needed from you.

Fund the wallet

Your agent reads its wallet address from getAgentWallet and shows it to you. Send USDC on Solana to that address. At least $5 covers a card order.

From there the agent calls agentX402Pay instead of paying endpoints directly. See the managed agent wallet guide for the full flow, including the per-payment guardrails for external endpoints.

A managed wallet can pay any x402 endpoint, not just Laso’s. Skip to step 2 below; the Locus endpoint-registration guide does not apply.

Locus provides wallet infrastructure purpose-built for AI agents.Tell your agent:

Read https://paywithlocus.com/SKILL.md and follow the instructions to set up Locus

Your agent will walk through the Locus onboarding, but it needs a few things from you first:

Create a Locus account

Go to app.paywithlocus.com and sign up with your email.

Deploy a wallet

From the dashboard, click Create Wallet. This deploys a smart wallet on the Base blockchain (~30 seconds). Save your private key — it’s shown only once.

Fund your wallet

Transfer USDC on Base or Solana to the wallet address shown on your dashboard. You’ll need at least $5 to order a card.

Generate an API key

Go to the API Key section and generate a key (starts with claw_). Copy it immediately — it’s shown only once.

Configure x402 endpoints

Navigate to x402 Endpoints in the Locus dashboard and add the Laso Finance endpoints your agent will use. See the Locus x402 Configuration guide for detailed instructions on adding each endpoint with the correct parameters.

This step is required! Without configuring the x402 endpoints, your agent won’t be able to call Laso Finance APIs through Locus.

Give your agent the API key

When your agent asks for a Locus API key, provide the claw_ key you generated.

Sponge provides agent wallets with automatic x402 service discovery.Tell your agent:

Read https://wallet.paysponge.com/skill.md and follow the instructions to set up Sponge Wallet

Your agent will walk through the Sponge onboarding, but it needs a few things from you first:

Agent registers

Your agent calls POST /api/agents/register with agentFirst: true to get an API key immediately (starts with sponge_live_). A claim URL is returned for human verification.

Claim the wallet

Open the claim URL from the registration response to verify and take ownership of the wallet.

Fund your wallet

Transfer USDC on Base or Solana to the wallet address. You’ll need at least $5 to order a card.

Discover Laso Finance endpoints

Sponge discovers x402 services automatically. Your agent calls GET /api/discover?query=laso to find available Laso Finance endpoints, then uses POST /api/x402/fetch to call them. No manual endpoint configuration needed.

Ampersend provides self-custody agent wallets on Base or Solana with dual-approval spending. Both you and the agent must authorize every payment, with per-transaction, daily, and monthly limits you control. Laso Finance is a default skill for Ampersend, so paywalled endpoints work natively with no manual registration.

Go to ampersend.ai and create an account.

Create and fund a new agent

From the dashboard, click + New agent, then choose Set up now in the confirmation dialog and complete. You’ll need at least $5 to order a card; you can fund later from the agent’s page.

Choose your agent framework

On the Set up your agent screen, pick the framework you’re using. For Claude Code, OpenClaw, or other CLI-based agents, select OpenClaw, Claude Code or other CLI-based agents at the top.

Paste the setup prompt into your agent

Ampersend will display a prompt like:

Read https://www.ampersend.ai/getting-started.md
and connect to my existing agent account:
  agent address: 0x...

Paste it into your agent. The agent installs the Ampersend skill and CLI on its own and replies with an auth link (https://app.ampersend.ai/approvals/setup-agent/<token>) and a 6-digit verification code. Open the link, confirm the code matches, and approve. Once approved, tell the agent it’s verified — it will run ampersend setup finish and the wallet is ready to make x402 payments to Laso Finance.

2. Authenticate with Laso Finance

Once your agent has a funded wallet, tell it to call the /auth endpoint to get API credentials. This endpoint is free: your agent proves wallet ownership with a SIGN-IN-WITH-X signature header. Tokens are returned for use in subsequent requests. Tell your agent:

Authenticate with the Laso Finance API by calling GET https://laso.finance/auth
with a SIGN-IN-WITH-X header. Save the id_token, refresh_token, and user_id
from the response.

The /auth response includes:

id_token — Bearer token for authenticated endpoints (like /get-card-data). Expires after ~1 hour.
refresh_token — Use with POST /auth (grant_type: "refresh_token") to get a new id_token when it expires.
user_id — Your agent’s user ID (derived from wallet address).

Your agent should store these credentials and reuse them across requests. /auth and /get-card return fresh tokens — always save them. When the id_token expires, call POST /auth with grant_type: "refresh_token" and the refresh_token — no payment needed.

3. Discover available endpoints

Your agent can discover everything it needs from these standard files:

File	URL	Purpose
Agent skill file	laso.finance/SKILL.md	Step-by-step instructions for agents
OpenAPI spec	laso.finance/openapi.json	Machine-readable API schema
AI plugin manifest	laso.finance/.well-known/ai-plugin.json	Agent discovery manifest
LLM context	laso.finance/llms.txt	LLM-optimized summary

Point your agent at https://laso.finance/SKILL.md and it can figure out the rest on its own.

4. What your agent can do

Once authenticated, point your agent at any of these flows. Each guide covers the full happy path, parameters, response shape, and example agent prompts.

Order a USA prepaid card

Best for U.S. online merchants. Two-step flow: provision the card, then poll /get-card-data for the number, CVV, and expiry.

Order an international prepaid card

Works with non-U.S. merchants and addresses. Stays queued until an admin fulfills the order (typically within 24 hours).

Send money to a debit card

Push USDC out to any USD, EUR, or GBP debit card. The recipient completes a short form at the returned redemption_url.

Order a gift card

Pick a brand from the multi-brand catalog with /search-gift-cards, then order by laso_server_id. Redemption details returned instantly.

Open a bank account

Real US bank details for dollars in, and a payout address for dollars out. Your agent runs the whole setup except identity verification.

Pay any x402 endpoint

With a Laso-managed wallet, your agent can settle 402 challenges on external services too, with a price ceiling you pin per call.

Check merchant compatibility

Search the merchant database before ordering to confirm a retailer accepts Laso prepaid cards.

Authenticate and refresh tokens

SIGN-IN-WITH-X, ID tokens, and OAuth2 refresh — the plumbing that backs every paywalled call.

The USA prepaid card is U.S. only — issued in USD, usable at U.S. merchants only, and physical goods must ship to a U.S. address. For international purchases, use the international prepaid card instead.

Next steps

Making a purchase

Walk through ordering a card and buying something with your agent.

Managing multiple agents or need spending guardrails? 1Claw’s Payment Card Vault wraps the Laso API with per-agent spending limits, automatic PAN redaction, and audit-logged reveals — so your agents can order cards without ever seeing the full card number.

Get started

Spend

Banking

Wallet

Platform

Integrations

Agent quickstart: set up a wallet and spend USDC

1. Set up your agent’s wallet

2. Authenticate with Laso Finance

3. Discover available endpoints

4. What your agent can do

Order a USA prepaid card

Order an international prepaid card

Send money to a debit card

Order a gift card

Open a bank account

Pay any x402 endpoint

Check merchant compatibility

Authenticate and refresh tokens

Next steps

Making a purchase

​1. Set up your agent’s wallet

​2. Authenticate with Laso Finance

​3. Discover available endpoints

​4. What your agent can do

Order a USA prepaid card

Order an international prepaid card

Send money to a debit card

Order a gift card

Open a bank account

Pay any x402 endpoint

Check merchant compatibility

Authenticate and refresh tokens

​Next steps

Making a purchase

1. Set up your agent’s wallet

2. Authenticate with Laso Finance

3. Discover available endpoints

4. What your agent can do

Next steps