Developer API

The hosted API is https://otv.poptrust.me. Authenticate with Authorization: Bearer or X-OTV-Api-Key. The browser session uses X-OTV-Session. Google sign-in is enabled on the hosted site.

Endpoints

• POST /v1/verify/incoming — submit a claim. Body fields: chain, network, transactionHash, recipient, and optional asset and expectedAmount.
• GET /v1/verdicts/{id} — fetch a stored verdict.
• POST /v1/verdicts/verify — check a verdict signature.
• GET /v1/chains, GET /v1/networks, GET /v1/assets — registry.
• POST /v1/webhooks and GET /v1/webhooks — workspace notifications.
• GET /v1/wallet/balance — read a balance from chain state. This does not send a transaction.
• POST /v1/demo/verification/run — simulation only. It does not broadcast a transaction.
• GET /v1/openapi.json — the API's own OpenAPI document. Interactive UI: /api/docs.

Rate limit headers are returned on API responses. Do not send seeds, private keys, or wallet passwords. Production requires Postgres. Verification follows the evidence in a fixed order.

Related

Scan a transaction · Look up a verdict · Explore documentation · Download the Android app