> ## Documentation Index
> Fetch the complete documentation index at: https://agents.laso.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# TypeScript quickstart for the Laso Finance API

> Integrate with the Laso Finance x402 API from TypeScript using x402-axios. Order your first prepaid card with a USDC payment on Base or Solana in minutes.

## 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.

<Tabs>
  <Tab title="Laso-managed (start here)">
    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 third-party provider signup 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:

    <Steps>
      <Step title="Let your agent sign in">
        Your agent calls `GET /auth` and gets its credentials. Nothing is needed from you.
      </Step>

      <Step title="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.
      </Step>
    </Steps>

    From there the agent calls `agentX402Pay` instead of paying endpoints directly. See the [managed agent wallet guide](/guides/managed-agent-wallet) for the full flow, including the per-payment guardrails for external endpoints.

    <Note>
      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.
    </Note>
  </Tab>

  <Tab title="Locus">
    [Locus](https://paywithlocus.com) 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:

    <Steps>
      <Step title="Create a Locus account">
        Go to [app.paywithlocus.com](https://app.paywithlocus.com) and sign up with your email.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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](/guides/locus-x402-setup) for detailed instructions on adding each endpoint with the correct parameters.

        <Warning>
          This step is required! Without configuring the x402 endpoints, your agent won't be able to call Laso Finance APIs through Locus.
        </Warning>
      </Step>

      <Step title="Give your agent the API key">
        When your agent asks for a Locus API key, provide the `claw_` key you generated.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Sponge">
    [Sponge](https://wallet.paysponge.com) 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:

    <Steps>
      <Step title="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.
      </Step>

      <Step title="Claim the wallet">
        Open the claim URL from the registration response to verify and take ownership of the wallet.
      </Step>

      <Step title="Fund your wallet">
        Transfer USDC on **Base** or **Solana** to the wallet address. You'll need at least \$5 to order a card.
      </Step>

      <Step title="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.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Ampersend">
    [Ampersend](https://www.ampersend.ai) 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.

    <Steps>
      <Step title="Sign up at ampersend.ai">
        Go to [ampersend.ai](https://www.ampersend.ai/) and create an account.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 2. Order a card

Once your agent has a funded wallet, it can call the Laso Finance `/get-card` endpoint. The [x402 protocol](https://www.x402.org/) handles the payment flow automatically.

```typescript theme={null}
import { wrapAxios } from "x402-axios";
import axios from "axios";

const client = wrapAxios(axios, wallet);

const { data } = await client.get("https://laso.finance/get-card", {
  params: { amount: 50 },
});

const { auth, card } = data;
// card.card_id — use this to poll for card details
// auth.id_token — use this for authenticated requests
```

The response includes:

* `auth.id_token` and `auth.refresh_token` for authenticated API calls
* `card.card_id` with `status: "pending"`

## 3. Poll for card details

Card details (number, CVV, expiry) take \~7-10 seconds to become available. Poll `/get-card-data` until `status` is `"ready"`.

```typescript theme={null}
async function waitForCard(idToken, cardId) {
  while (true) {
    const { data } = await axios.get("https://laso.finance/get-card-data", {
      params: { card_id: cardId },
      headers: { Authorization: `Bearer ${idToken}` },
    });

    if (data.status === "ready") {
      return data.card_details;
    }

    await new Promise((r) => setTimeout(r, 3000));
  }
}

const cardDetails = await waitForCard(auth.id_token, card.card_id);
// cardDetails.card_number
// cardDetails.cvv
// cardDetails.exp_month / cardDetails.exp_year
// cardDetails.available_balance
```

## 4. Use the card

You now have a prepaid card. Use the card number, CVV, and expiry to make purchases at any US-based merchant.

<Note>
  The USA prepaid card (`/get-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 `GET /order-intl-card` instead.
</Note>

## Full example

```typescript theme={null}
import { wrapAxios } from "x402-axios";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";
import axios from "axios";

// Set up wallet with your private key
const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const wallet = createWalletClient({
  account,
  chain: base,
  transport: http(),
});

// Wrap axios with x402 payment handling
const client = wrapAxios(axios, wallet);

// Order a $50 prepaid card
const { data } = await client.get("https://laso.finance/get-card", {
  params: { amount: 50 },
});

const { auth, card } = data;

// Poll until card details are ready
let cardDetails;
while (!cardDetails) {
  const res = await axios.get("https://laso.finance/get-card-data", {
    params: { card_id: card.card_id },
    headers: { Authorization: `Bearer ${auth.id_token}` },
  });

  if (res.data.status === "ready") {
    cardDetails = res.data.card_details;
  } else {
    await new Promise((r) => setTimeout(r, 3000));
  }
}

console.log("Card ready:", cardDetails);
```

<Tip>
  Cards are non-reloadable. If you're making an online purchase, ideally order a
  card for the exact checkout total so no funds are left over on the card.
</Tip>

## Next

<Card title="Making a purchase" icon="cart-shopping" href="/guides/making-a-purchase">
  Buy something online with the card your agent just ordered.
</Card>