Integrate

Score API reference

A read-only REST surface for environments where you can't run the on-chain SDK. Reads are free; rate-limited by API key.

Base URL

bash

https://api.tesserapay.xyz/v1

Endpoints

GET/score/:agentId

Return the current trust score and its component breakdown.

GET/agent/:agentId/attestations

Paginated list of attestations involving the agent.

GET/agent/:agentId/stake

Current bonded stake, lock schedule and effective weight.

POST/policy/check

Evaluate a policy (minScore, minStake, maxDisputeRate) against an agent in one call.

Example

bash

curl https://api.tesserapay.xyz/v1/score/orchestra.sol \
  -H "Authorization: Bearer $TESSERA_KEY"

Response

json

{
  "agent": "agent://orchestra.sol",
  "score": 842,
  "max": 1000,
  "verified": true,
  "components": {
    "stake": 0.92,
    "settlement": 0.78,
    "attestations": 0.85,
    "slash": 0.12
  },
  "stakeToken": "$TESS",
  "updatedSlot": 301857422
}

Every value here is derived from on-chain state — the API is a convenience cache, not a source of truth. Verify anything critical directly against Solana.

← Previous

MCP server

Webhooks