Swap USDC for BALD tokens on Base via a pay-per-call x402 endpoint
What it does
This x402 endpoint at bald.x420.dev executes a token swap, purchasing BALD tokens (contract 0x110B4ef11db22eEb3caFCB53a58b8B6B1bCDEb07) on the Base network using USDC. The caller pays via the x402 payment protocol — specifically 1 USDC (maxAmountRequired: 1,000,000 in 6-decimal USDC units) per call — and receives BALD tokens in return. The payment is sent to address 0x93109d14F6665a9c9675290D3cD5A6c07bBAfdbd, and the USDC asset used is the canonical Base USDC at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.
The endpoint responds with a JSON object containing the swap transaction hash, a send transaction hash, the number of BALD tokens received, and the USDC amount paid. The BALD token was created via Clanker and is viewable on clanker.world. The landing page at bald.x420.dev also references Clanker WETH reward claiming, though that functionality is wallet-based and separate from this API endpoint.
Documentation is minimal — the /docs, /api, /pricing, and /README paths all return placeholder pages. The only technical specification available is the x402 challenge's outputSchema. There is no OpenAPI spec, no detailed usage guide, and no rate-limit or SLA information.
Capabilities
Use cases
- —Programmatically purchasing BALD tokens with USDC on Base
- —Agent-driven token acquisition without manual wallet interaction
- —Automated DeFi portfolio building that includes memecoins on Base
Fit
Best for
- —AI agents that need to autonomously swap USDC for specific tokens on Base
- —Developers experimenting with x402 payment-gated DeFi endpoints
- —Automated trading bots targeting Clanker-launched tokens
Not for
- —Users needing detailed swap parameters like slippage control or limit orders
- —Production trading systems requiring SLA guarantees and documentation
- —Swapping tokens on networks other than Base
Quick start
curl -X GET https://bald.x420.dev/api/puff \
-H "X-PAYMENT: <x402-payment-header>"Example
Response
{
"message": "Swap successful",
"tokensReceived": "1500000000000000000000",
"usdcAmountPaid": "1000000",
"sendTransactionHash": "0x789abc...012def",
"swapTransactionHash": "0xabc123...def456"
}Endpoint
Quality
The endpoint is live and returns a valid x402 challenge with an outputSchema, but there is no OpenAPI spec, no documentation beyond the landing page, and no information about rate limits, slippage, or error handling. The response schema is inferred entirely from the x402 challenge.
Warnings
- —No documentation available — /docs, /api, /pricing, /README all return placeholder pages
- —No OpenAPI or formal API specification provided
- —Response example is inferred from outputSchema in the x402 challenge, not from actual observed responses
- —This endpoint executes real financial transactions (token swaps) — use with caution
- —BALD is a memecoin with no guaranteed liquidity or value
- —No slippage protection or swap parameter customization is documented
Citations
- —The x402 challenge requires 1,000,000 units (1 USDC) payment to 0x93109d14F6665a9c9675290D3cD5A6c07bBAfdbd on Basehttps://bald.x420.dev/api/puff
- —BALD token contract address is 0x110B4ef11db22eEb3caFCB53a58b8B6B1bCDEb07https://bald.x420.dev
- —BALD was created via Clanker and is viewable on clanker.worldhttps://bald.x420.dev
- —The USDC asset on Base is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913https://bald.x420.dev/api/puff