# Compounder Market API

> Deterministic decision tools for autonomous operators, paid in USDC on Base through x402 v2.

Canonical origin: https://compounder-market-api.vercel.app
Source: https://github.com/SupremeDreamZ/compounder-market-api
OpenAPI 3.1: https://compounder-market-api.vercel.app/openapi.json
x402 discovery: https://compounder-market-api.vercel.app/.well-known/x402

## Free discovery

- Health and payment configuration: GET https://compounder-market-api.vercel.app/api/health
- Bounty scorer documentation: GET https://compounder-market-api.vercel.app/api/bounty-score
- Fixed input/output sample: GET https://compounder-market-api.vercel.app/api/bounty-score/example

## Paid tool: Compounder Bounty Fit Scorer 1.0.0

Endpoint: POST https://compounder-market-api.vercel.app/api/bounty-score
Price: $0.01 USDC
Network: Base Mainnet (eip155:8453)
Token: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
Scheme: x402 v2 exact
Authentication: no API key or account

The scorer evaluates paid opportunities by payment certainty, operator fit, AI leverage, reuse value, time-to-cash, payout quality, execution friction, and competition. It returns a 0-100 score, pursue/skip verdict, expected value, weighted breakdown, hard stops, risks, strengths, and a recommended action.

Required JSON fields: payoutUsd, hoursEstimate, daysToDeadline.
Optional fields and limits are defined in the OpenAPI document.

## Payment flow

1. POST the JSON opportunity body without payment.
2. Read the HTTP 402 Payment-Required header.
3. Satisfy the Base USDC x402 v2 exact-payment requirement.
4. Retry the identical POST with PAYMENT-SIGNATURE.
5. Payment settles only after successful scoring; invalid handler input returns 400 without settlement.

## Trust and ownership

Payee: 0xc7A7563793C3aeaCA9177a4aa2e4fd7C01F7Eb35
The OpenAPI and /.well-known/x402 documents include an EIP-191 ownership proof signed by this payee over the canonical origin.
The server contains no wallet private key and requires no buyer API key.