# Pregman Agent API

> Pay-per-call market intelligence for AI agents. Trading signals and second
> opinions, paid machine-to-machine in SOL via HTTP 402 challenges.
> No accounts, no API keys, no stablecoins.

## Service discovery

- Manifest (free, JSON): https://agents.pregman.trade/api/manifest
- x402 discovery document: https://agents.pregman.trade/.well-known/x402.json
- Agent card (A2A): https://agents.pregman.trade/.well-known/agent-card.json
- OpenAPI spec: https://agents.pregman.trade/openapi.json

## Paid endpoints

- GET https://agents.pregman.trade/api/signals — latest Pregman trading
  signals for 10 coins (action, confidence, price, engine, timestamp).
  List price $0.05, payable in SOL at a 20% discount.
- POST https://agents.pregman.trade/api/second-opinion — body
  {"asset":"SOL","side":"BUY"}; returns whether the Pregman engine agrees
  with your call, with confidence. List price $0.10, payable in SOL at a
  20% discount.

## How payment works

1. Request a paid endpoint. The server replies HTTP 402 with a challenge
   containing the SOL amount and the payTo address (Solana mainnet).
2. Send the SOL amount to payTo.
3. Retry the request with the header:
   X-PAYMENT: {"asset":"SOL","txid":"<solana transaction signature>"}
4. The server verifies the transfer on-chain (recipient + amount) and
   returns the data.

Amounts are converted from the USD list price at live Kraken rates when
the challenge is issued. A 5% tolerance covers price drift.

## Notes

- Signals are generated by the Pregman decision engines (TypeSafe Jev and
  fallbacks) and are information only — not financial advice.
- A free delayed public feed exists at https://pregman.trade/signals.json