# CostPulse — Full API Documentation

> Cheapest AWS region, region comparison, workload pricing and savings; AWS Price List data refreshed daily
> Price: $0.01/query | Protocol: x402 | Networks: Solana + Base

## Endpoints

### /v1/cheapest?service={service}&sku={sku}
- Method: GET
- Price: $0.01 (10000 atomic USDC)
- Auth: X-API-Key (AWS Marketplace key, mp_...), PAYMENT-SIGNATURE header (x402) or Authorization: Bearer key

### /v1/compare?service={service}&sku={sku}&regions={csv}
- Method: GET · same price and auth

### /v1/workload?services={service:sku,service:sku}
- Method: GET · same price and auth

### /v1/savings?service={service}&sku={sku}&current_region={region}
- Method: GET · same price and auth

### /health
- Method: GET
- Price: No auth required
- Returns: { service: "CostPulse", status: "ok" }

### /llms.txt
- Method: GET
- Price: No auth required
- Returns: Machine-readable service index

## Authentication

### AWS Marketplace key
Subscribe on AWS Marketplace; your key (mp_...) is stored in your AWS Secrets Manager. Send it as X-API-Key. A wrong or inactive key answers 401.

### MCP and A2A
- MCP endpoint: https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp
- A2A agent card: https://costpulse.waltsoft.net/.well-known/agent-card.json

### x402 (no account)
1. Make request without payment
2. Parse 402 response PAYMENT-REQUIRED header (base64 JSON)
3. Sign payment authorization (EIP-3009 on Base, SPL transfer on Solana)
4. Retry with PAYMENT-SIGNATURE header

## Payment Details
- Asset: USDC (6 decimals)
- Amount: 10000 atomic = $0.01
- Solana payTo: GsKr5q9TmiJQcEgUpBp2X6SmvSg3dnXuw2uxYJxgPTk8
- Base payTo: 0x318A4B4764eb37c3FCBcE434713128143815FD57
- Solana feePayer: resolved dynamically from GET /platform/v2/x402/supported (CDP fee-payer pool rotates; do not hardcode)

## Provider
Waltsoft · https://waltsoft.net · 16 intelligence APIs for AI agents