Agent Trust Gate Endpoint

GET /v1/trust-gate

Binary allow/deny decision. Returns a simple pass/fail based on a minimum score threshold. Designed for protocols that need a one-line trust check before executing a transaction.

Endpoint URL

https://agent-api.fairscale.xyz/v1/trust-gate?wallet=WALLET_ADDRESS

Parameters

Parameter	Type	Required	Default	Description
`wallet`	string	Yes	-	Solana wallet address
`min_score`	number	No	`40`	Minimum score threshold (0–100)
`require_verification`	boolean	No	-	If `true`, requires at least one registry verification
`task`	string	No	-	Scoring profile to apply

Example Request

curl "https://agent-api.fairscale.xyz/v1/trust-gate?wallet=WALLET&min_score=60&require_verification=true" \
  -H "fairkey: zpka_your_key_here"

Response Schema

Example Response

{
  "wallet": "WALLET",
  "allowed": true,
  "score": 67,
  "reason": "score_above_threshold",
  "meta": { "from_cache": false, "provider": "FairScale" }
}