Get a SAMPLE-FIXTURE preview of the PaladinFi token-contract trust check.
⚠️ NOT a real evaluation. Returns fixed sample data with `_preview: true`,
every factor marked `real: false`, and recommendation prefixed `sample-`
(`sample-allow` / `sample-warn` / `sample-block`). Use this for shape-testing
your integration; DO NOT use the verdict to gate real swaps, signing, or any
production agent decision.
**Programmatic safety check**: before consuming any field of this response,
agents should test `resp.get("_real") is True` (top-level) — preview always
returns `_real: false`. Substring-matching on `recommendation` (e.g.
`"allow" in resp["trust"]["recommendation"]`) will INCORRECTLY match
`sample-allow`; use exact-equality (`resp["trust"]["recommendation"] == "allow"`)
or test the `_real` field instead.
For REAL evaluations (3 paths, cheapest -> most-featured):
- **Free wallet-OFAC screen (v0.11.77+)**: `POST https://swap.paladinfi.com/v1/trust-check/ofac`
- anonymous, rate-limited (1 r/s + burst 3), runs only the OFAC SDN
wallet-screen leg with real data (`_real: true`). Returns the same
`recommendation: "allow" | "block"` shape as the full endpoint (no
`warn` state — OFAC is binary). Useful for agents that just need
sanctions screening without the full composition. Includes
`_paid_endpoint_info` upgrade hint pointing at the paid endpoint.
Wallet-OFAC scope — the Treasury SDN list carries wallet/EOA addresses,
not token contracts. Use the paid endpoint for token-contract risk.
- Install `@paladinfi/eliza-plugin-trust` (ElizaOS) or
`@paladinfi/agentkit-actions` (Coinbase AgentKit). Both handle x402
payment ($0.001 USDC per call on Base) automatically and expose a
`paladin_trust_check` action to your agent.
- OR call `POST https://swap.paladinfi.com/v1/trust-check` via an
x402-capable HTTP client. See https://paladinfi.com/trust-check/
for full integration docs.
The paid endpoint composes live OFAC SDN screening (refreshed daily from the
Treasury XML feed), GoPlus token security, Etherscan source verification, and
PaladinFi anomaly + lookalike heuristics into a single
`recommendation: "allow" | "warn" | "block"` verdict.