# TickTape - For agents (API)

Independent preflight verdicts for Polymarket. Paid per call via x402
(USDC on Base, network eip155:8453). HTTP 402 is the whole onboarding:
call, read the payment terms, pay, retry. No account or issued API key -
pay per request, or use an optional prepaid bearer token.

## Endpoints

- `GET /api/preflight_trade?slug=<market>&outcome=<name>&side=BUY&usd=100` - $0.02
  Order verdict: OK/CAUTION/VETO with expected slippage, depth, taker fees,
  safe size, book age. Threshold overrides: max_slippage_c, veto_slippage_c,
  max_book_age_s.
- `GET /api/preflight_copy?wallet=0x<40hex>` - $0.10
  Wallet verdict: COPY/WATCH/VETO with fee-inclusive copier ROI, win rate,
  entry profile, farming screen. Fixed $5-entry/+2c simulation from
  TickTape's private tape; size-and-delay replay is not live. Unknown
  wallet: HTTP 202 QUEUED (free), typically ready in minutes (the
  response's retry_after_seconds tells you when to retry); worst case
  about an hour.
- `GET /api/leaderboard` - $0.02 - wallets rated COPY/WATCH.
- `GET /api/red_list` - $0.02 - wallets that lose money for copiers.
- `POST /api/credits` - $5 -> 500 credits + bearer token - half the
  per-call price, ~0.4s responses.

## Free

`?sandbox=1` deterministic example on every tool (unlimited);
`?x402_probe=1` exact payment terms without paying.

## Contract files

[agent.json](https://ticktape.cc/agent.json) |
[openapi.json](https://ticktape.cc/openapi.json) |
[auth.md](https://ticktape.cc/auth.md) |
[pricing.md](https://ticktape.cc/pricing.md) |
[llms.txt](https://ticktape.cc/llms.txt)