# CostPulse — Find the cheapest AWS region for any service instantly.

Two ways to pay: an AWS Marketplace subscription key (header X-API-Key: mp_..., billed on your AWS bill), or $0.01 per query with x402 and no signup. Errors are never billed.

## Quick Start
```
GET https://costpulse.waltsoft.net/v1/cheapest?service=ec2&sku=m5.xlarge
GET https://costpulse.waltsoft.net/v1/compare?service=ec2&sku=m5.xlarge&regions=us-east-1,eu-west-1
GET https://costpulse.waltsoft.net/v1/workload?services=ec2:m5.xlarge,rds:db.m5.large
GET https://costpulse.waltsoft.net/v1/savings?service=ec2&sku=m5.xlarge&current_region=eu-west-1
Header: X-API-Key: <mp_ key>   or   PAYMENT-SIGNATURE: <base64 x402 payment proof>
```

## Price
$0.01 per query (10000 atomic USDC on Solana or Base mainnet)

## What You Get
The cheapest commercial AWS region for a service SKU, per-region comparisons, workload pricing and savings, from AWS Price List data refreshed daily. Structured JSON.

## MCP and A2A
- MCP (Amazon Bedrock AgentCore Gateway): https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp — tools costpulse___getCheapestRegion, costpulse___compareRegions, costpulse___calculateSavings (pass api_key)
- A2A agent card: https://costpulse.waltsoft.net/.well-known/agent-card.json
- OpenAPI 3: https://costpulse.waltsoft.net/openapi.json

## How to Pay (x402 Protocol)
1. GET the endpoint without payment → receive 402 with payment requirements
2. Sign a USDC transfer authorization for 10000 atomic units
3. Base64-encode the signed proof as PAYMENT-SIGNATURE header
4. Retry the request → get your data

## Networks
- Solana: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp (USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)
- Base: eip155:8453 (USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)

## Provider
Waltsoft (https://waltsoft.net) — 16 APIs for AI agents, all on AWS Marketplace