Quick Start

Quick Start (Production)

This guide walks through setting up a Locus agent on the production environment.

Environment: Production API Base: https://api.paywithlocus.com/api Dashboard: app.paywithlocus.com API Key Prefix: claw_dev_*

Create an account at app.paywithlocus.com. You’ll need to verify your email.

Step 2: Create a wallet

After logging in, click Create Wallet on the dashboard. Save the private key shown on screen — this is your recovery key. Wait ~30 seconds for your smart wallet to deploy on Base.

Step 3: Generate an API key

In the API Key section of your dashboard, click Generate API Key. Copy the key immediately — it starts with claw_dev_ and is only shown once. The same panel manages a sandbox key (claw_sandbox_…). It works on every agent endpoint with realistic dummy responses and never moves money or spends credits — use it to verify your integration before funding the wallet, even while the wallet is still deploying. Sandbox responses carry an X-Locus-Sandbox: true header, and your configured spending controls are simulated against a fixed 25 USDC balance so policy and approval handling can be tested too. Agents that self-register via POST /api/register receive both keys in the registration response.

Step 4: Fund your wallet

Send USDC (on Base) to the wallet address shown on your dashboard. You can also request credits if you’d like to try things out first.

Step 5: Set spending controls (optional)

From the dashboard, configure safety limits for your agent:

Allowance — maximum total USDC the agent can spend
Max transaction size — cap on any single transaction
Approval threshold — transactions above this amount require your manual approval

Step 6: Connect your agent

Send this to your agent:

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

Your agent will prompt you for the API key you generated in Step 3. Alternatively, save credentials directly:

mkdir -p ~/.config/locus
cat > ~/.config/locus/credentials.json << 'EOF'
{
  "api_key": "claw_dev_your_key_here",
  "api_base": "https://api.paywithlocus.com/api"
}
EOF

Step 7: Verify it works

curl https://api.paywithlocus.com/api/pay/balance \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY"

Expected response (200):

{
  "success": true,
  "data": {
    "balance": "100.00",
    "token": "USDC",
    "wallet_address": "0xYourWallet..."
  }
}

If you get a 401, the key is wrong — regenerate it from the dashboard.

Our skill files are standard SKILL.mds and work with any compatible agent framework.

Production endpoints

Resource	URL
API Base	`https://api.paywithlocus.com/api`
Dashboard	`https://app.paywithlocus.com`
SKILL.md	`https://paywithlocus.com/skill.md`
ONBOARDING.md	`https://paywithlocus.com/onboarding.md`
CHECKOUT.md	`https://paywithlocus.com/checkout.md`
LASO.md	`https://paywithlocus.com/laso.md`

What’s next?

Platform Walkthrough

Tour the dashboard and all its features.

Features

Explore wallets, transfers, tasks, and Laso Finance.

Request Credits

Get free USDC credits to try Locus.

Agent tools

Discover and call pay-per-use tools without separate provider accounts.

Getting started

Features

Agent tools

Build with Locus

Checkout

Quick Start (Production)

Step 2: Create a wallet

Step 3: Generate an API key

Step 4: Fund your wallet

Step 5: Set spending controls (optional)

Step 6: Connect your agent

Step 7: Verify it works

Production endpoints

What’s next?

Platform Walkthrough

Features

Request Credits

Agent tools

​Quick Start (Production)

​Step 1: Sign up

​Step 2: Create a wallet

​Step 3: Generate an API key

​Step 4: Fund your wallet

​Step 5: Set spending controls (optional)

​Step 6: Connect your agent

​Step 7: Verify it works

​Production endpoints

​What’s next?

Platform Walkthrough

Features

Request Credits

Agent tools

Quick Start (Production)

Step 1: Sign up

Step 2: Create a wallet

Step 3: Generate an API key

Step 4: Fund your wallet

Step 5: Set spending controls (optional)

Step 6: Connect your agent

Step 7: Verify it works

Production endpoints

What’s next?