Buy yaoming tokens ($yaoming) on Base with USDC via x402 payment protocol
What it does
This x402 endpoint allows agents and users to purchase yaoming tokens (contract 0x73DB2BE4581BcE956501eD0e2156DC31939B2b07) on the Base network by paying with USDC. The endpoint accepts a POST request with an optional `amount` field specifying how much USDC to spend (defaults to 5 USDC if omitted, up to a maximum of 5 USDC per transaction based on the x402 challenge). Payment is handled via the x402 protocol's X-PAYMENT header using USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) on Base.
The response includes the swap transaction hash, send transaction hash, the number of tokens received, and the USDC amount paid. The token was created via Clanker and is hosted on the x420.dev platform, which provides x402-enabled storefronts for Clanker-launched tokens. No separate API documentation exists beyond the x402 challenge schema and the landing page.
Note that this is a speculative memecoin token swap endpoint. The yaoming token has no documented utility beyond trading. The maximum payment per call is 5 USDC (5000000 in 6-decimal USDC units). The endpoint timeout is 120 seconds, reflecting the on-chain swap execution time.
Capabilities
Use cases
- —Programmatically purchasing yaoming tokens using USDC on Base
- —Agent-driven token accumulation or portfolio building
- —Automated memecoin trading via x402-compatible wallets
Fit
Best for
- —AI agents that need to execute on-chain token swaps via HTTP
- —Developers building x402-integrated trading bots
- —Users wanting a simple HTTP-based interface to buy a specific Clanker token
Not for
- —Purchasing tokens on networks other than Base
- —Swapping tokens other than yaoming
- —Large trades exceeding 5 USDC per transaction
Quick start
curl -X POST https://yaoming.x420.dev/api/puff-custom \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402_payment_header>" \
-d '{"amount": "2.5"}'Example
Request
{
"amount": "2.5"
}Response
{
"message": "Successfully swapped USDC for yaoming tokens",
"tokensReceived": "150000.0",
"usdcAmountPaid": "2.5",
"sendTransactionHash": "0x789ghi...jkl012",
"swapTransactionHash": "0xabc123...def456"
}Endpoint
Quality
The x402 challenge is live and includes a well-defined outputSchema with input/output fields. However, there is no API documentation (docs/api/pricing pages all return 'doesn't exist'), no OpenAPI spec, and the response example is inferred from the schema rather than observed. The endpoint is functional but documentation is minimal.
Warnings
- —No API documentation exists — /docs, /api, /pricing all return placeholder pages
- —This endpoint facilitates purchase of a speculative memecoin with no documented utility
- —Response example is inferred from outputSchema, not from an actual observed response
- —Maximum transaction size is 5 USDC, limiting practical use for larger trades
Citations
- —The x402 challenge returns a maxAmountRequired of 5000000 (5 USDC) with USDC asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Basehttps://yaoming.x420.dev/api/puff-custom
- —The token contract is 0x73DB2BE4581BcE956501eD0e2156DC31939B2b07 and was created via Clankerhttps://yaoming.x420.dev
- —The outputSchema specifies an optional amount field defaulting to 5 USDC and returns swapTransactionHash, sendTransactionHash, tokensReceived, and usdcAmountPaidhttps://yaoming.x420.dev/api/puff-custom
- —The endpoint timeout is 120 secondshttps://yaoming.x420.dev/api/puff-custom