BROCCOLI GUARDIANBY F2B

EVIDENCE API · VERSION 2

ONE CONTRACT.
TRACEABLE EVIDENCE.

Retrieve the latest Guardian investigation as structured data, including pool scope, causal trace, risk impact and the cryptographic evidence receipt.

01

AUTHENTICATED ENDPOINT

Latest individual investigation

GET/api/v1/investigation?address=0x…
curl "https://broccolif2b.com/api/v1/investigation?address=0xCONTRACT" \
  -H "Authorization: Bearer bg_live_YOUR_KEY"

API keys are created inside Guardian Account. Keys are shown once, stored only as a one-way hash and subject to the account rate limit.

02

RESPONSE CONTRACT

Fields institutions can audit

verdict

Observed risk state for the captured snapshot.

coverage

Completeness of the investigation, never a safety score.

causalAnalysis

Signal, exact pool, pinned block, reproduction, confirmed sells, cause status and final impact.

forensics

Current route, independent probes and provider sample reconciliation.

receipt

Stable receipt ID and SHA-256 evidence fingerprint.

limitations

Explicit boundaries that prevent overclaiming.

03

STATUS BEHAVIOR

Fail clearly

200Evidence returned
400Invalid contract
401Missing or invalid key
404No investigation snapshot
429Rate limit reached
503Evidence service unavailable

An unavailable source or unresolved cause does not become a passing result. The response preserves the limitation.

INSTITUTIONAL BOUNDARYThe API supplies evidence, not investment advice.

Every result belongs to one contract, one pool scope and one captured chain state. Consumers must retain the receipt and limitations with any downstream decision.