# Base Alpha

> Base Alpha is a DEX aggregator on Base (chain ID 8453) with a CEX-style trading interface.
> It routes swaps across Aerodrome, Uniswap V3, and PancakeSwap V3 for best execution.
> Website: https://base-alpha.xyz

## For more detail
- Full context: https://base-alpha.xyz/llms-full.txt
- OpenAPI spec: https://base-alpha.xyz/openapi.json
- Agent discovery: https://base-alpha.xyz/.well-known/agents.json
- Agent API docs: https://base-alpha.xyz/agents

## Agent API (x402-protected, pay with USDC on Base)

### GET /api/agent/quote
Get the best swap quote across all DEXes.
- Price: $0.001 per request
- Params: tokenIn (address), tokenOut (address), amountIn (raw uint256), slippageBps (optional, default 50)
- Returns: amountOut, minAmountOut, pool, dexId, dexName, feeBps, feeAmount, pricePerTokenIn

### POST /api/agent/swap
Build an unsigned swap transaction routed through FeeRouter.
- Price: $0.01 per request
- Body: tokenIn, tokenOut, amountIn, slippageBps?, recipient
- Returns: transaction (to, data, value, chainId), approval (token, spender, amount), quote
- The agent must: (1) approve approval.spender for approval.amount of approval.token, then (2) send transaction

### GET /api/agent/tokens
List all available tokens with USD prices.
- Price: $0.001 per request
- Returns: tokens array (address, symbol, decimals, priceUsd), total

### GET /api/agent/pools
List liquidity pools, optionally filtered by token.
- Price: $0.001 per request
- Params: token0 (optional), token1 (optional)
- Returns: pools array (address, token0, token1, token0Symbol, token1Symbol, tvlUsd, dexId, dexName), total

## x402 Payment Protocol
- All endpoints return HTTP 402 with PaymentRequirements if no X-PAYMENT header is present.
- Asset: USDC on Base (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 decimals)
- Facilitator: https://x402.org/facilitator
- Use the x402 npm package or any x402-compatible client to create payment headers.

## Common Token Addresses (Base)
- WETH: 0x4200000000000000000000000000000000000006
- USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- cbBTC: 0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf
- AERO: 0x940181a94A35A4569E4529A3CDfB74e38FD98631

## On-Chain Fees
- Platform fee: 0% deducted from amountIn before swap
- Fee is routed through FeeRouter contract: 0x674ea383052461f94d08CfDA3245783C84B5EA6C