Developers
Agent API
Endpoints your AI or your app can call on Base. Request a result, review it and sign with your wallet. Pay per call in USDC with x402.
Endpoints by product
What your agent can call today.
- Live
Trading
- Swap routes
- Get calldata and the expected output after fees. Native ETH sells include a dry run. ERC-20 sells are not simulated yet.
- Quotes
- Compare swap outputs before requesting calldata.
- Cross-chain quotes
- Free LI.FI quotes for swaps on Base or between Base, Arbitrum, Optimism and Ethereum. Your wallet sends the transaction.
- Live
Orders and automations
- Limit orders
- Prepare a CoW Protocol order on Base, then relay it after your wallet has signed. Free.
- Automations
- Preview and create reserve refills, TWAPs and recurring buys. Your wallet signs each part when it is due, so nothing runs unattended.
- Live
Token and wallet data
- Token data
- Read token details, price and a quote-based round-trip proxy.
- Wallet balances
- Read token balances and available USD values.
- Live
Monitoring
- Balance and price alerts
- Get a signed webhook when a balance or price crosses your threshold.
- Live
Payouts
- Token distributions
- Build a hosted claim page for up to 100,000 Base addresses, then fetch one recipient proof at a time.
- Live
Controls and transparency
- Spending controls
- Set caps and task budgets for agent payments, read receipts and pause paid calls. Agents can only narrow limits.
Pay for what you use
No API key or subscription. Your agent pays each call in USDC with x402.
| Product | Price | What you get |
|---|---|---|
| Swap route | $0.01 + 0.1% of swap output | Best swap route across Base aggregators as ready-to-sign calldata, with a Beamswap fee of 10 bps (less for GLINT tiers) taken from the output token. |
| Token data | $0.005 | Base token facts: metadata, supply, deployer, USD price, round-trip liquidity check (quote-based proxy). |
| Wallet balances | $0.02 | All ERC-20 + ETH balances of a Base address with USD values. |
| Quote | $0.005 | Best swap output across Base aggregators (quote only, no calldata). |
| Monitoring | $0.01 per item per day | Watch Base balances or USD prices and get a signed webhook when a condition trips. Priced per item per day. |
USDC on Base. Monitoring is prepaid for the selected duration. Swap routes and watch creation do not use free quota. Stakers pay less: 10 / 25 / 40% off by tier.
How payment works
- Request the endpoint
- Sign the USDC payment
- Retry and receive the answer
Successful paid responses include a settlement receipt.
Make your first request
Send a request. A 402 response tells you what to pay.
A 402 response shows the payment required.
curl -i -X POST "https://api.beamswap.io/v1/execute/route" -H "content-type: application/json" -d '{"sell":"ETH","buy":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000000000000000000","from":"0xe598c65f960a8c39b539f31cabf2c28f1567fd54","recipient":"0xe598c65f960a8c39b539f31cabf2c28f1567fd54","slippageBps":50}'
# → 402 with a PAYMENT-REQUIRED header; retry with PAYMENT-SIGNATURE (any x402 client does this for you)GLINT staking benefits
Stake GLINT to unlock lower USDC prices, free daily calls and a lower Beamswap fee on the own route.
| Staked GLINT | Free calls / day | USDC discount | Swap fee |
|---|---|---|---|
| 0 | 0 | 0% | 0.1% |
| 100k | 200 | 10% | 0.1% |
| 1M | 2,000 | 25% | 0.05% |
| 10M | 20,000 | 40% | 0.03% |
Staking is live: stake GLINT at 0x0A18f9F3E047E606C17CfcE7C8e17bFF87a4D5a3 to unlock a tier. Unstaking has a seven-day cooldown.
Snapshot claimants receive tier 1 for the first 90 days from launch.
Eligible calls use a wallet session. Quota resets at 00:00 UTC. Unstaking has a seven-day cooldown.