# x402 Paid Service API

> This is a paid API service using the x402 payment protocol on Base network.

## Overview
- **Name**: Yennefer x402 Paid Service
- **Price**: $0.01 USDC per request
- **Network**: Base (Chain ID 8453)
- **Payment**: USDC via x402 protocol

## Endpoints

### POST /api/execute
Execute a paid service call. Returns 402 Payment Required if no payment proof.

**Headers Required**:
- X-Payment-Proof: <signature> (after payment)

**Request Body**: JSON object with service parameters

**Response**: JSON with execution result

### GET /.well-known/x402
Payment discovery endpoint. Returns pricing and contract details.

### GET /health
Health check endpoint.

## Payment Flow
1. Call POST /api/execute without payment
2. Receive 402 with X-Accept-Payment headers
3. Sign USDC transfer to vault contract
4. Retry with X-Payment-Proof header

## Contract Addresses
- Vault: 0xB6D9935af4478fc54404DD95aC0942D28de01F08
- USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

## Ambient Submit Skill

The `ambient-submit` skill enables natural language task submission to the Genesis Conductor fleet.

### Capabilities
- Submit async tasks: "let kiro handle this", "queue this job"
- Check job status: "what's the status of tsk_xxx"
- Fleet health: "fleet status", "check all workers"

### Agent Routing
- kiro: implementation, deployment
- codex: security fixes
- claude: architecture review
- gemini: GCP operations
- copilot: inline suggestions

### API
- POST /v1/tasks - Submit task
- GET /v1/jobs - Check status
- POST /v1/approvals/{id}/approve - Approve

### OpenAPI
https://optimization-inversion.genesisconductor.io/openapi.json

## Links
- x402 Spec: /.well-known/x402
- OpenAPI: /openapi.json