# 0x402 — Compound Trading Signals API

> Real-time US equity signals scored by an AutoResearch engine that continuously backtests and self-optimizes. Pay per request in USDC on Tempo via MPP. No API keys. No subscriptions.

## Base URL

https://0x402.link

## Payment

- Protocol: MPP (Machine Payments Protocol) — HTTP 402 flow
- Currency: USDC on Tempo mainnet (chain 4217)
- Currency address: 0x20c000000000000000000000b9537d11c60e8b50
- Recipient: 0xE2dd7B21Fdc9ba225A5B0D3cF9B86109E44C5C7F

Flow: request endpoint → receive 402 + WWW-Authenticate challenge → pay on Tempo → replay with Authorization header → receive data + Payment-Receipt.

## Endpoints

### GET /api/signals/scan — $0.02
Top 10 compound trading signals. Each ticker is scored across insider activity, congressional trades, technicals, and sentiment into a single conviction score with directional bias and source breakdown.

### GET /api/signals/score?ticker={TICKER} — $0.01
Deep score for one ticker (1-5 letter symbol). Returns composite score, individual signal components, conviction level, and reasoning.

### GET /api/insider/cluster-buys — $0.005
SEC Form 4 insider cluster buys from the past 7 days. Multiple insiders buying the same stock in a tight window — one of the most studied predictive patterns.

### GET /api/insider/officer-sells — $0.005
Notable C-suite and officer selling activity. Our strongest signal at 80% directional accuracy — large officer sales often precede weakness.

### GET /api/congress/recent — FREE
Congressional stock trades from the past 30 days. Member name, party, ticker, direction, and estimated size. Free demo endpoint — these trades feed into the compound scorer where convergence with insider + technical signals produces the real edge.

### GET /api/market/dashboard — $0.005
Market overview — sector performance, top movers, futures, VIX.

### GET /health — FREE
Service health, uptime, version, and endpoint listing.

## How the scoring works

The engine cross-references four independent data streams — SEC Form 4 filings, Capitol Trades congressional data, market technicals, and macro indicators — and produces a single conviction score per ticker.

Key finding from AutoResearch backtesting:
- Officer sells → 80% accuracy (strongest signal)
- Signal convergence (multiple sources agree) → historically 100% directional
- Insider cluster buys → 34% accuracy (mostly noise)
- Congressional trades → 33% accuracy (contrarian indicator)

Weights auto-adjust based on rolling backtest results.

## Quick start

### CLI (mppx)
```
mppx get https://0x402.link/api/signals/scan
mppx get "https://0x402.link/api/signals/score?ticker=NVDA"
mppx get https://0x402.link/api/insider/officer-sells
```

### Python (pympp)
```python
from mpp.client import get
from mpp.methods.tempo import tempo, TempoAccount, ChargeIntent

account = TempoAccount.from_key("0xYOUR_PRIVATE_KEY")
methods = [tempo(account=account, intents={"charge": ChargeIntent()})]

response = await get("https://0x402.link/api/signals/scan", methods=methods)
print(response.json())
```

### Raw HTTP
```
GET /api/signals/scan HTTP/1.1
Host: 0x402.link

→ 402 Payment Required
  WWW-Authenticate: Payment realm="0x402.link" ...

(complete Tempo payment)

GET /api/signals/scan HTTP/1.1
Host: 0x402.link
Authorization: Payment credential="..."

→ 200 OK
  Payment-Receipt: ...
  Content-Type: application/json
```

## Rate limits

100 requests/min per IP. Standard rate limit headers included.

## Errors

- 400: Bad input (invalid ticker, missing params)
- 402: Payment required (challenge in WWW-Authenticate)
- 429: Rate limited
- 500: Upstream failure (refund issued automatically if payment was captured)