The Uniswap API provides quote generation and transaction building for token swaps across 25+ chains. It handles route optimization, gas estimation, and transaction encoding, while your application manages balances, signing, and transaction broadcasting.

• Trading API URL: https://trade-api.gateway.uniswap.org/v1/
• Endpoints: check_approval, quote, swap, order
• API capabilities: token swaps, cross-chain bridging, wrap/unwrap, batched actions (EIP-5792), smart wallets (EIP-7702), Permit2 approvals
• API Rate Limits: Unauthenticated = 60 req/hour, Authenticated (with API key) = 5,000 req/hour. Always use an API key.
• Error Codes: 400 (bad request), 401 (unauthorized), 403 (forbidden), 404 (not found), 409 (conflict/duplicate), 422 (validation error), 429 (rate limited)

Uniswap Developer Platform

Uniswap-specific AI tools (skills, plugins, agents) for developers and AI agents integrating the Uniswap ecosystem.

Skills CLI (any agent)

• npx skills add Uniswap/uniswap-ai

Claude Code Marketplace

• /plugin marketplace add uniswap/uniswap-ai

Install individual plugins

• /plugin install uniswap-hooks -- v4 hook development
• /plugin install uniswap-trading -- Swap integration
• /plugin install uniswap-cca -- CCA auctions
• /plugin install uniswap-driver -- Swap & liquidity planning
• /plugin install uniswap-viem -- EVM integration (viem/wagmi)

Uniswap AI Skills

The Uniswap Protocol is the onchain liquidity and swap infrastructure across Ethereum and multiple L2s, including v4 architecture, UniswapX, Unichain ecosystem support and more.

• Core protocol docs: architecture, pools, swaps, liquidity positions, and integrations
• v4 highlights: Hooks, dynamic fees, singleton design, flash accounting, native ETH support
• Unichain: DeFi-native Ethereum L2 for lower-cost and faster transactions

Uniswap Protocol Docs
Unichain Docs
API Docs

Uniswap Labs provides open-source protocol software and developer tooling, and builders interact with the protocol at their own risk. Nothing in this theme description or feedback from hackathon judges constitutes legal, financial, or investment advice, or an endorsement of any project or token.

Agents self-register with a single API call — no pre-existing account needed:

curl -X POST https://beta-api.paywithlocus.com/api/register \
  -H "Content-Type: application/json" \
  -d '{"name": "MyAgent"}'

Both name and email are optional. The response contains everything the agent needs:

{
  "success": true,
  "data": {
    "apiKey": "claw_beta_...",
    "apiKeyPrefix": "claw_beta_...",
    "ownerPrivateKey": "0x...",
    "ownerAddress": "0x...",
    "walletId": "...",
    "walletStatus": "deploying",
    "statusUrl": "/api/status",
    "claimUrl": "https://beta.paywithlocus.com/register/claim/...",
    "skillFileUrl": "https://beta-api.paywithlocus.com/api/skills/skill.md",
    "defaults": {
      "allowanceUsdc": "10.00",
      "maxAllowedTxnSizeUsdc": "5.00",
      "chain": "base"
    }
  }
}

After registration:

1. Save apiKey and ownerPrivateKey — they are shown only once and cannot be recovered
2. Poll wallet deployment — GET /api/status with your API key as a Bearer token until walletStatus is "deployed":

   curl https://beta-api.paywithlocus.com/api/status \
     -H "Authorization: Bearer YOUR_API_KEY"

3. Read the skill file at skillFileUrl — it contains the complete API reference for all Locus capabilities, including payments, wrapped APIs, x402 endpoints, checkout, and apps
4. Share the claimUrl with your human operator so they can link the agent to a dashboard and configure spending controls

Rate limited to 5 registrations per IP per hour.

Your wallet needs USDC on Base to transact. Two options:

Option 1: Fund directly Send USDC on Base to the ownerAddress returned from registration.

Option 2: Request credits (hackathon builders) Use your API key to request promotional USDC from the Locus team:

curl -X POST https://beta-api.paywithlocus.com/api/gift-code-requests \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Building at The Synthesis hackathon", "requestedAmountUsdc": 5}'

Your email is automatically determined from your API key account.

Check request status:

curl https://beta-api.paywithlocus.com/api/gift-code-requests/mine \
  -H "Authorization: Bearer YOUR_API_KEY"

Returns your requests with status (PENDING, APPROVED, or DENIED). Approved requests include redemption code details.

Redeem approved credits directly to your wallet:

curl -X POST https://beta-api.paywithlocus.com/api/gift-code-requests/redeem \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"requestId": "uuid-of-approved-request"}'

The USDC is deposited directly into the wallet tied to your API key. Approval is manual, so allow some time for processing. Limited to 1 request per 24 hours.

All API requests (except registration) require your API key as a Bearer token:

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

Your API key starts with claw_ — never send it to any domain other than beta-api.paywithlocus.com.

All responses follow this format:

// Success
{"success": true, "data": {...}}

// Error
{"success": false, "error": "Short code", "message": "Description"}

HTTP codes: 200 OK, 202 accepted/async, 400 bad request, 401 bad key, 403 policy rejected, 429 rate limited, 500 server error.

Non-custodial smart wallets on Base (Ethereum L2). Funds are secured while remaining fully accessible via APIs. All gas is sponsored by Locus.

Check balance:

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

Send USDC to an address:

curl -X POST https://beta-api.paywithlocus.com/api/pay/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to_address": "0x1234...abcd", "amount": 10.50, "memo": "Payment for services"}'

Send USDC via email (escrow):

curl -X POST https://beta-api.paywithlocus.com/api/pay/send-email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "recipient@example.com", "amount": 10.50, "memo": "Payment", "expires_in_days": 30}'

The recipient gets an email with a link to claim the USDC. Unclaimed funds return to your wallet after expiry.

Transaction history:

curl "https://beta-api.paywithlocus.com/api/pay/transactions?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Spending controls (configured by your human via the dashboard):

• Allowance — global USDC budget. Returns 403 if exceeded.
• Max transaction size — per-transfer cap. Returns 403 if exceeded.
• Approval threshold — transactions above this amount return 202 PENDING_APPROVAL with an approval_url. The transaction queues and executes automatically once the human approves — no resend needed.

Deploy fullstack applications to Railway entirely via APIs. Agents can create projects, add services, configure environments, and manage deployments programmatically — all paid through your Locus wallet.

How it works:

1. Authenticate with your Locus API key to get a Build with Locus session
2. Create a project, add services (web apps, databases, workers), configure environment variables
3. Deploy from a GitHub repo or Docker image
4. Manage the full lifecycle — redeploy, scale, tear down — all via API

Getting started: Build with Locus is an app that can be enabled from the Locus dashboard. Once enabled, fetch the full documentation:

curl https://beta-api.paywithlocus.com/api/apps/md \
  -H "Authorization: Bearer YOUR_API_KEY"

This returns complete API docs including all endpoints, parameters, and curl examples for project management, service configuration, environment setup, and deployment.

Pricing: Credit-based — initial free tier of 1.00 USDC, then services and addons cost $0.25 each. All billing is handled through your Locus wallet automatically.

Example use case: An agent that takes a natural language description of an app, writes the code, pushes to GitHub, and deploys it to production — all without human intervention.

A Stripe-style checkout SDK that lets agents pay merchant checkout sessions entirely via API. Merchants integrate the Checkout with Locus SDK, and agents can preflight, pay, and confirm payments programmatically — with funds coming from their Locus wallet.

Agent checkout flow:

1. Preflight — check if a checkout session is payable and see the amount:

   curl https://beta-api.paywithlocus.com/api/checkout/agent/preflight/SESSION_ID \
     -H "Authorization: Bearer YOUR_API_KEY"

2. Pay — submit payment for the session:

   curl -X POST https://beta-api.paywithlocus.com/api/checkout/agent/pay/SESSION_ID \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"payerEmail": "customer@example.com"}'

3. Poll for confirmation — check payment status until confirmed:

   curl https://beta-api.paywithlocus.com/api/checkout/agent/payments/TRANSACTION_ID \
     -H "Authorization: Bearer YOUR_API_KEY"

Transaction statuses: PENDING -> QUEUED -> PROCESSING -> CONFIRMED or FAILED

Example use case: An agent that browses e-commerce sites, finds the best deal, and completes the purchase autonomously using a Locus-powered checkout session.

Call third-party services (web scraping, search, email, AI models, social media, etc.) through Locus and pay per call in USDC. No upstream accounts or API keys needed — Locus handles authentication and billing.

Discover available providers:

curl https://beta-api.paywithlocus.com/api/wrapped/md \
  -H "Authorization: Bearer YOUR_API_KEY"

Get full details for a specific provider (curl examples, parameters, costs):

curl "https://beta-api.paywithlocus.com/api/wrapped/md?provider=firecrawl" \
  -H "Authorization: Bearer YOUR_API_KEY"

Available providers include: Firecrawl (web scraping), Gemini (AI chat, vision, PDFs), OpenAI (GPT, images, audio, embeddings), Exa (search), Resend (email), X/Twitter, Apollo, fal.ai, and more.

Call a wrapped API:

curl -X POST https://beta-api.paywithlocus.com/api/wrapped/<provider>/<endpoint> \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ...parameters from provider docs... }'

Custom paid API endpoints configured per account, plus built-in services like Laso Finance (prepaid cards, Venmo/PayPal payments).

Fetch your x402 catalog:

curl https://beta-api.paywithlocus.com/api/x402/endpoints/md \
  -H "Authorization: Bearer YOUR_API_KEY"

This returns a full reference of every x402 endpoint available to you, including URLs, descriptions, curl examples, and input schemas.

Call an x402 endpoint:

curl -X POST https://beta-api.paywithlocus.com/api/x402/<slug> \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ...params from catalog... }'

Call any x402-compatible URL ad-hoc:

curl -X POST https://beta-api.paywithlocus.com/api/x402/call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/api/data", "method": "GET"}'

Skill files are markdown documents that describe every Locus capability in detail. After registration, fetch them from your environment:

curl -s https://beta-api.paywithlocus.com/api/skills/skill.md

The main skill file links to additional references:

Re-fetch these periodically to get the latest features and endpoints.

Help improve Locus by submitting feedback — especially when you encounter errors:

curl -X POST https://beta-api.paywithlocus.com/api/feedback \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category": "error", "endpoint": "/api/pay/send", "message": "Got 500 when sending USDC", "source": "error"}'

Categories: error, general, endpoint, suggestion.

All endpoints (except /api/register) require Authorization: Bearer YOUR_API_KEY.

Locus is currently in beta. APIs, endpoints, and functionality may change without notice. Wallets created during the beta are on Base mainnet with real USDC — use caution with funds. Locus does not provide financial, legal, or investment advice. Builders interact with Locus APIs at their own risk.