# AiSpace x402 Marketplace

> Pay-per-request AI inference with USDC on Base. Built in Venice. No Venice API key.

Origin: https://x402.aispace.bot
Product (humans): https://aispace.bot
Docs: https://docs.aispace.bot/agent-api
OpenAPI: https://x402.aispace.bot/openapi.json
Well-known: https://x402.aispace.bot/.well-known/x402.json

## Path of least resistance

CLI (default):

```bash
npx @aispace.bot/x402 models --type text
export AISPACE_X402_KEY=0x<base-usdc-wallet>
npx @aispace.bot/x402 chat --model venice-uncensored --message "hi" --max-tokens 256
```

## Complementary options

- MCP: `npx -y @aispace.bot/x402 mcp` (Cursor / Claude Desktop)
- Raw HTTP: unpaid call → HTTP 402 → `X-402-Payment` retry (see docs)

## Machine discovery

- GET /openapi.json — routes, x-guidance, info.x-pricing (Venice rates × priceMult)
- GET /api/v1/models?type=text|image|video|music|tts|asr|embedding — free catalogs
- POST /api/v1/video/quote | /api/v1/audio/quote — free accurate job quotes
- Live settlement price: HTTP 402 `accepts[].amount` (always authoritative)

## Pricing rule

Agent charge = Venice-equivalent upstream USD × priceMult (env). No fake category floors. Unknown price → error, not a cheap 402.

## Optional

- x402scan directory listing for this origin
- Stats (aggregate): GET /api/x402/stats