Integrate with AgentProof

Add trust scoring to your protocol in 3 steps. Gate DeFi actions, filter agent marketplaces, or verify agent reputation before transacting.

Pricing

Pay-per-call: $0.05 per API call. No commitment, no minimum. Register and start querying.

Volume subscriptions for lower per-call pricing:

	Pay-per-call	Starter	Growth	Scale	Enterprise
Monthly calls	Unlimited	10,000	25,000	75,000	200,000
Per call	$0.05	$0.025	$0.02	$0.013	$0.01
Monthly price	Usage-based	$250	$500	$1,000	$2,000
Batch size	50	100	200	300	500
Webhooks	3	5	10	25	Unlimited

Quick Start

Get your API key

curl -X POST https://oracle.agentproof.sh/api/v1/integrations/register \
  -H "Content-Type: application/json" \
  -d '{"protocol_name": "My Protocol", "contact_email": "dev@example.com"}'

Query trust scores

curl https://oracle.agentproof.sh/api/v1/trust/1380 \
  -H "X-Api-Key: ap_live_your_key_here"

Returns: { composite_score, tier, recommendation, risk_flags, score_breakdown }

Set up webhooks (get notified when agent scores or tiers change)

curl -X POST https://oracle.agentproof.sh/api/v1/webhooks \
  -H "X-Api-Key: ap_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"subscriber_name": "My Protocol", "webhook_url": "https://my-app.com/webhooks/agentproof", "events": ["score_change", "tier_change"]}'

Batch Evaluation (Growth+)

curl -X POST https://oracle.agentproof.sh/api/v1/trust/batch \
  -H "X-Api-Key: ap_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"agent_ids": [1380, 1375, 1199, 888], "chain": "base"}'

Python Example

import httpx

ORACLE = "https://oracle.agentproof.sh"
API_KEY = "ap_live_your_key_here"
headers = {"X-Api-Key": API_KEY}

# Single evaluation
r = httpx.get(f"{ORACLE}/api/v1/trust/1380", headers=headers)
eval = r.json()
print(f"Score: {eval['composite_score']}, Tier: {eval['tier']}")

# Gate by tier
if eval["tier"] not in ("gold", "platinum", "diamond"):
    raise Exception("Agent does not meet minimum trust tier")

JavaScript Example

const ORACLE = "https://oracle.agentproof.sh";
const API_KEY = "ap_live_your_key_here";

const res = await fetch(`${ORACLE}/api/v1/trust/1380`, {
  headers: { "X-Api-Key": API_KEY }
});
const { composite_score, tier, recommendation } = await res.json();

if (tier === "diamond" || tier === "platinum") {
  // Reduce collateral requirements for trusted agents
}

On-Chain Integration

For fully on-chain reputation gating, use the TrustScoreOracle contract. The oracle pushes composite scores on-chain; your contracts read them with a small per-query fee.

// Solidity
ITrustScoreOracle oracle = ITrustScoreOracle(ORACLE_ADDRESS);
(uint16 score, uint8 tier, ) = oracle.getScore{value: oracle.queryFee()}(agentId);
require(tier >= 3, "Agent must be Gold or above");

Endpoints Reference

Method	Endpoint	Description
`POST`	/api/v1/integrations/register	Get API key
`GET`	/api/v1/integrations/usage	Usage dashboard
`POST`	/api/v1/integrations/upgrade	Upgrade tier
`GET`	/api/v1/trust/{agent_id}	Trust evaluation
`GET`	/api/v1/trust/{agent_id}/risk	Risk assessment
`POST`	/api/v1/trust/batch	Batch evaluation (Growth+)
`GET`	/api/v1/agents/trusted	Search trusted agents
`POST`	/api/v1/webhooks	Register webhook
`GET`	/api/v1/network/stats	Network statistics

Questions? Contact team@agentproof.sh · Back to Oracle