Blockchain — entry 009 of 11
TWZRD Agent Intel
TWZRD is a Solana-native trust layer that AI agents call before and after making an x402 micropayment, returning a signed reputation receipt for a given wallet instead of gating access behind a signup-based API key. A free sample receipt and verifier endpoint let integrators test the signing scheme before spending real USDC on a live trust lookup, priced at $0.05 per call. Its JSON responses carry no CORS headers, so it's built to be called server-side or by an agent, not from a browser.
GreatAPIs Score
Auth quickstart
- No key needed — call it now.
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
x402 Facilitator (Path B)3
Opt-in settle-through-TWZRD: /supported feePayer GWRLgRB6diC2zG9BaoGJsan9T8JvJCk7usFruiefnfMP, /verify, /settle with V6 receipt + merchant_attach.
POST/settleCreate an x402 payment settlement on Solana
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | Settle result. success=true includes transaction + best-effort twzrd_receipt/merchant_attach; success=false with errorReason for policy/replay (e.g. duplicate_settlement) still HTTP 200. | — |
400 | Malformed body (missing paymentPayload/paymentRequirements). | — |
503 | Facilitator unavailable or agent_intel_disabled. | — |
GET/supportedFetch supported x402 payment schemes
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
POST/verifyVerify an x402 payment payload
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | Verify result. isValid=true when policy+payload OK; isValid=false with invalidReason for policy/replay rejects (still HTTP 200 for scheme outcomes). | — |
400 | Malformed body (missing paymentPayload/paymentRequirements). | — |
503 | Facilitator unavailable or agent_intel_disabled. | — |
Paid Trust Intel (Path A)7
Paid trust / merchant mint / quick - each 402 accepts[] entry names its own extra.feePayer. Down-only screening evidence.
GET/v1/intel/merchant/{pubkey}Fetch paid merchant track record by pubkey
| Name | In | Required | Type |
|---|---|---|---|
pubkey | path | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | Paid response (JSON) including settlement tx. | — |
402 | Payment required (x402). Returns payment-required header. | — |
503 | Surface disabled (WZRD_AGENT_INTEL_ENABLED=false). | — |
POST/v1/intel/merchant/{pubkey}Fetch paid merchant track record by pubkey
| Name | In | Required | Type |
|---|---|---|---|
pubkey | path | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | Paid response (JSON) including settlement tx. | — |
402 | Payment required (x402). Returns payment-required header. | — |
503 | Surface disabled (WZRD_AGENT_INTEL_ENABLED=false). | — |
GET/v1/intel/quick/{pubkey}Fetch a quick seller risk score by pubkey
| Name | In | Required | Type |
|---|---|---|---|
pubkey | path | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | Paid response (JSON) including settlement tx. | — |
402 | Payment required (x402). Returns payment-required header. | — |
503 | Surface disabled (WZRD_AGENT_INTEL_ENABLED=false). | — |
POST/v1/intel/quick/{pubkey}Fetch quick seller risk score by pubkey
| Name | In | Required | Type |
|---|---|---|---|
pubkey | path | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | Paid response (JSON) including settlement tx. | — |
402 | Payment required (x402). Returns payment-required header. | — |
503 | Surface disabled (WZRD_AGENT_INTEL_ENABLED=false). | — |
GET/v1/intel/reality-checkFetch the x402 Reality Check PDF
| Status | Description | Schema |
|---|---|---|
200 | Paid Reality Check PDF stream after x402 settlement. | — |
402 | Payment required (x402). Returns payment-required header. | — |
503 | Surface disabled (WZRD_AGENT_INTEL_ENABLED=false). | — |
GET/v1/intel/trust/{pubkey}Fetch paid counterparty trust by pubkey
| Name | In | Required | Type |
|---|---|---|---|
pubkey | path | yes | string |
seller_wallet | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Paid response (JSON) including settlement tx. | — |
402 | Payment required (x402). Returns payment-required header. | — |
503 | Surface disabled (WZRD_AGENT_INTEL_ENABLED=false). | — |
POST/v1/intel/trust/{pubkey}Fetch paid counterparty trust by pubkey
| Name | In | Required | Type |
|---|---|---|---|
pubkey | path | yes | string |
seller_wallet | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Paid response (JSON) including settlement tx. | — |
402 | Payment required (x402). Returns payment-required header. | — |
503 | Surface disabled (WZRD_AGENT_INTEL_ENABLED=false). | — |
Free Preflight Screening3
Free allow/warn/block preflight and merchant_card wash/conformance.
POST/v1/agent-readinessVerify x402 seller endpoint readiness
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | AgentReadinessCard with per-axis findings and a verdict. | — |
400 | Missing/invalid url (HTTPS required), or the audit could not resolve a card. | — |
503 | Surface disabled (WZRD_AGENT_INTEL_ENABLED=false). | — |
GET/v1/intel/merchant_card/{wallet}Fetch a merchant risk card by wallet
| Name | In | Required | Type |
|---|---|---|---|
wallet | path | yes | string |
resource_id | query | no | string |
full | query | no | boolean |
X-Twzrd-Caller | header | no | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
POST/v1/intel/preflightRun an x402 seller preflight
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
Resource Directory (SOT)1
Resource join single source of truth: listed | live_402 callables.
GET/v1/intel/resourcesList callable x402 resources with seller risk
| Name | In | Required | Type |
|---|---|---|---|
limit | query | no | integer |
offset | query | no | integer |
live_402_only | query | no | boolean |
include_inactive | query | no | boolean |
min_unique_payers | query | no | integer |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
Receipts2
V6 receipt example + offline verify.
GET/v1/receipts/exampleFetch a sample signed V7 receipt
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
POST/v1/receipts/verifyVerify a portable V7 receipt
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
Discovery & Ops30
Health, descriptors, badges, secondary research.
GET/.well-known/agent-card.jsonFetch the TWZRD A2A agent card
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/.well-known/x402Fetch the x402 service descriptor
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/healthFetch TWZRD service health
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/llms.txtFetch agent-facing TWZRD guidance
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/openapi.jsonFetch the TWZRD OpenAPI document
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
POST/v1/compute/inferenceRun receipt-gated model inference
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
400 | Missing required wallet or prompt field. Body also names the live x402 completions SKU on api.twzrd.xyz. | — |
402 | Active TWZRD Receipt required, or wallet receipt tier is below Silver. | — |
502 | Receipt resolver or inference backend unavailable. | — |
GET/v1/intel/badge/{pubkey}Fetch an intel badge by pubkey
| Name | In | Required | Type |
|---|---|---|---|
pubkey | path | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/compare_walletsCompare two wallets before payment
| Name | In | Required | Type |
|---|---|---|---|
wallet_a | query | yes | string |
wallet_b | query | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/demo-gateRun the no-spend buyer gate demo
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/get_counterpartiesList a payer's x402 counterparties
| Name | In | Required | Type |
|---|---|---|---|
wallet | query | yes | string |
limit | query | no | integer |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/get_facilitator_footprintFetch a payer facilitator footprint
| Name | In | Required | Type |
|---|---|---|---|
wallet | query | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/get_poec_scoreFetch a wallet PoEC preview
| Name | In | Required | Type |
|---|---|---|---|
wallet | query | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/get_top_intel_agentsList observed x402 payer agents
| Name | In | Required | Type |
|---|---|---|---|
limit | query | no | integer |
min_paid_calls | query | no | integer |
max_days_since_last | query | no | number |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/marketplaceList indexed x402 services with wash risk
| Name | In | Required | Type |
|---|---|---|---|
flagged_only | query | no | boolean |
limit | query | no | integer |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/payto-feedFetch wash/payTo diffs for a local deny list
| Name | In | Required | Type |
|---|---|---|---|
chain | query | yes | string |
since_seq | query | no | integer |
snapshot_cursor | query | no | integer |
limit | query | no | integer |
include | query | no | string |
X-Twzrd-Caller | header | no | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
POST/v1/intel/refuse-receiptCreate a caller-local deny receipt
| Name | In | Required | Type |
|---|---|---|---|
X-Twzrd-Caller | header | no | string |
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
202 | Legacy caller-local deny receipt. | — |
422 | INVALID_REFUSAL_SIGNATURE or INVALID_REFUSAL_PAYLOAD. | — |
429 | Rate limited; retry after Retry-After. | — |
503 | Signing or persistent storage unavailable; not logged. | — |
POST/v1/intel/refuse-receipt/verifyVerify a refuse-receipt (not V6)
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/score_wallet_for_intelScore a wallet from observed x402 history
| Name | In | Required | Type |
|---|---|---|---|
wallet | query | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
POST/v1/intel/score_wallets_batchScore a batch of Solana wallets
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/sellersList observed Solana x402 sellers
| Name | In | Required | Type |
|---|---|---|---|
min_payers | query | no | integer |
limit | query | no | integer |
offset | query | no | integer |
wash_flagged_only | query | no | boolean |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
POST/v1/intel/verify-endpointVerify a seller x402 endpoint with a signed receipt
| Status | Description | Schema |
|---|---|---|
200 | Paid response (JSON) including settlement tx. | — |
402 | Payment required (x402). Returns payment-required header. | — |
503 | Surface disabled (WZRD_AGENT_INTEL_ENABLED=false). | — |
GET/v1/intel/watchList active seller re-call watches
| Name | In | Required | Type |
|---|---|---|---|
payer_wallet | query | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
POST/v1/intel/watchRegister a seller re-call watch
| Name | In | Required | Type |
|---|---|---|---|
payer_wallet | query | yes | string |
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
DELETE/v1/intel/watch/{watch_id}Delete a seller re-call watch
| Name | In | Required | Type |
|---|---|---|---|
watch_id | path | yes | integer |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/x402-demoRun the sample x402 trust flow
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
GET/v1/intel/x402-directoryList ingested x402 services with wash risk
| Name | In | Required | Type |
|---|---|---|---|
flagged_only | query | no | boolean |
limit | query | no | integer |
source | query | no | string |
network | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
POST/v1/reputation/analyzeRun batch merchant reputation analysis
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
401 | Invalid Pro API key when premium gating is enabled. | — |
402 | Pro access required when premium gating is enabled; request may be satisfied with Pro API key, CCM-qualified wallet, or x402 Solana USDC settlement. | — |
422 | Invalid request body. | — |
GET/v1/reputation/badge/{merchant}Fetch a reputation badge by merchant
| Name | In | Required | Type |
|---|---|---|---|
merchant | path | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
POST/v1/wash/analyzeRun batch wallet wash analysis
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
401 | Invalid Pro API key when premium gating is enabled. | — |
402 | Pro access required when premium gating is enabled; request may be satisfied with Pro API key, CCM-qualified wallet, or x402 Solana USDC settlement. | — |
422 | Invalid request body. | — |
GET/v1/wash/badge/{wallet}Fetch a wash-risk badge by wallet
| Name | In | Required | Type |
|---|---|---|---|
wallet | path | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | OK (JSON). | — |
API Hosted Inference1
POST/v1/chat/completionsRun paid OpenAI-compatible inference
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | OpenAI-compatible chat.completion JSON. | — |
402 | Payment required (x402). Returns payment-required header. | — |
Try it
Developer reference
https://intel.twzrd.xyz- GET/health
- GET/supported
- GET/v1/intel/marketplace
- GET/v1/receipts/example