Skip to main content

​
Installation

pip install agentscore

​
Quick start

from agentscore import AgentScore

client = AgentScore(api_key="your-api-key")

# Summary lookup (free tier)
summary = client.reputation("0xdb5aa553feeb2c3e3d03e8360b36fb0f7e480671")
print(summary.score, summary.grade)

# On-the-fly assessment with decision (paid tier)
assessment = client.assess(
    "0xdb5aa553feeb2c3e3d03e8360b36fb0f7e480671",
    policy={"min_grade": "B", "min_score": 50},
)

if assessment.decision == "deny":
    print("Denied:", assessment.decision_reasons)

​
API reference

​
Constructor

AgentScore(
    api_key: str,
    base_url: str = "https://api.agentscore.sh",
    timeout: float = 10.0,
)

​
client.reputation(address, **kwargs)

Look up a wallet’s cached reputation profile. 
result = client.reputation(
    address,
    chain="base",   # optional, default "base"
)

​
client.assess(address, **kwargs)

On-the-fly trust assessment with policy evaluation. Paid tier only. 
result = client.assess(
    address,
    policy={
        "min_grade": "B",
        "min_score": 50,
        "require_verified_payment_activity": False,
    },
    refresh=False,   # optional, force recomputation
)

if result.decision == "deny":
    print("Denied:", result.decision_reasons)

​
client.stats()

stats = client.stats()
print(f"{stats.wallets_scored} wallets scored")

​
Async support

from agentscore import AsyncAgentScore

client = AsyncAgentScore(api_key="your-api-key")

result = await client.reputation("0xdb5aa553feeb2c3e3d03e8360b36fb0f7e480671")

​
Error handling

from agentscore import AgentScoreError

try:
    rep = client.reputation("0xinvalid")
except AgentScoreError as e:
    print(e.code)     # "invalid_address"
    print(e.message)  # "The provided wallet address is not a valid EVM address."
    print(e.status)   # 400

​
Environment variable

The SDK reads AGENTSCORE_API_KEY from the environment if no api_key is passed: 
export AGENTSCORE_API_KEY=sk_live_abc123...

client = AgentScore()  # uses AGENTSCORE_API_KEY