# Sharvora Intelligence API

Sharvora release **1.4.0-rc9-proof** provides x402 v2 pay-per-request JSON resources on Base mainnet (`eip155:8453`).

## Payment flow
1. Request a purchasable resource without a payment signature.
2. Receive HTTP `402 Payment Required` with a `PAYMENT-REQUIRED` header.
3. Sign the declared exact USDC payment with an x402-compatible buyer client.
4. Retry using `PAYMENT-SIGNATURE`.
5. On successful verification and settlement, receive the JSON result and a `PAYMENT-RESPONSE` header.

Never send a seed phrase or wallet private key to Sharvora.

## Purchasable resources
- `GET /api/v1/service-proof` — `$0.001` — Use as a low-cost end-to-end x402 canary before higher-value calls. A successful paid response proves Sharvora delivery and returns release, network, time and a response receipt.
- `POST /api/v1/quant/risk-state` — `$0.020` — Use when an agent has an ordered numeric series and needs volatility, drawdown, anomaly and regime context before making a downstream decision.
- `POST /api/v1/quant/anomaly` — `$0.030` — Use to rank unusual observations in a supplied numeric series with transparent z-score and median-absolute-deviation evidence.
- `POST /api/v1/quant/forecast-range` — `$0.050` — Use for a simple probabilistic 80% range estimate from a supplied time series when an agent needs bounded uncertainty, not a trade instruction.
- `POST /api/v1/quant/flow-monitor` — `$0.030` — Use to normalize supplied exchange, bridge and stablecoin inflow/outflow values into net-flow direction and intensity context.
- `POST /api/v1/decision/preflight` — `$0.050` — Use immediately before an automated decision to check observation age, missing context and optional series risk for explicit warning conditions.
- `POST /api/v1/decision/journal` — `$0.100` — Use to create a durable auditable decision record with a stable decision_id, context hash, horizon, direction and confidence for later evaluation.
- `POST /api/v1/decision/bundle` — `$0.120` — Use when an agent wants one payment and one response for freshness, completeness, risk, anomaly and forecast evidence over the same supplied series.
- `POST /api/v1/decision/audit` — `$0.050` — Use after an outcome is known to compare it with a prior Sharvora decision record and calculate change and directional hit evidence.
- `POST /api/v1/web/trust-passport` — `$0.150` — Use when an agent wants one integrated trust purchase: combines agent readiness, bounded endpoint-risk heuristics, redirect evidence, HTTP policy, browser security headers and TLS posture into a scored evidence passport.
- `POST /api/v1/web/agent-readiness` — `$0.020` — Use to audit whether a public website exposes machine-readable agent surfaces such as robots, sitemap, llms.txt/llms-full, OpenAPI, RFC 9727 API catalog, A2A discovery, x402 and security.txt.
- `POST /api/v1/web/redirect-audit` — `$0.020` — Use to inspect a public URL redirect chain, cross-origin hops, loops and HTTPS-to-HTTP downgrade evidence with private-network redirect protection.
- `POST /api/v1/web/endpoint-trust` — `$0.050` — Use before an agent trusts a public endpoint: combines bounded public fetching, redirect and browser-policy evidence, and a deterministic static scan for common prompt-injection and credential-exfiltration language.
- `POST /api/v1/web/http-policy` — `$0.030` — Use to inspect a public HTTP response's cache, CORS, cookie and browser-policy posture as a point-in-time evidence snapshot.
- `POST /api/v1/web/security-headers` — `$0.020` — Use for a no-login audit of a public HTTP(S) page's major browser security headers and a prioritized list of missing protections.
- `POST /api/v1/web/tls-report` — `$0.020` — Use to check a public hostname's TLS certificate issuer, SAN coverage, cipher and expiry window without requiring credentials to the target site.
- `POST /api/v1/x402/validate` — `$0.005` — Use to inspect a public x402 URL without spending funds: confirms HTTP 402 behavior and decodes v2 payment metadata when available.
- `POST /api/v1/evidence/receipt` — `$0.010` — Use when an agent needs a deterministic SHA-256 content-integrity receipt for exact UTF-8 text. This is off-chain and does not claim notarization.
- `POST /api/v1/evidence/consensus` — `$0.060` — Use to measure agreement, freshness and contradictions across caller-supplied numeric observations with transparent confidence and weighting evidence.

## Discovery
- Catalog: `https://sharvora.com/api/v1/catalog`
- x402: `https://sharvora.com/.well-known/x402`
- API catalog: `https://sharvora.com/.well-known/api-catalog`
- OpenAPI: `https://sharvora.com/openapi.json`
- llms.txt: `https://sharvora.com/llms.txt`
- llms-full.txt: `https://sharvora.com/llms-full.txt`
- Pricing: `https://sharvora.com/api/v1/pricing`
- Launch readiness: `https://sharvora.com/api/v1/launch-readiness`
- Free capability router: `https://sharvora.com/api/v1/router/recommend?goal=YOUR_GOAL`
- Free quote and structural preflight: `POST https://sharvora.com/api/v1/quote`

## Use and risk
Sharvora outputs are informational/technical decision-support primitives, not investment, legal, tax, accounting, cybersecurity certification, or other regulated professional advice. Buyers remain responsible for downstream decisions and target authorization.

## Response trust model
Native deterministic and user-supplied-data products include `_meta` fields for release, observation time, provenance class, methodology, freshness and warnings. Web-intelligence products probe only public network targets.

## Errors
- `400/415/422`: invalid input, wrong content type, or blocked private/non-public target; paid POST preflight rejects these before settlement and returns `charged:false`
- `402`: payment required or payment not accepted
- `404`: requested stored decision does not exist
- `503`: preserved legacy product is not currently available for purchase, or payments are fail-closed