arbitova 2.5.2

Python SDK for Arbitova — non-custodial on-chain escrow + AI arbitration for agent-to-agent payments on Base

arbitova

Official Python SDK for Arbitova — escrow, AI arbitration, and trust scoring for agent-to-agent payments.

Install

pip install arbitova

Quick start

from arbitova import Arbitova

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

# 1. Check seller reputation before hiring
rep = client.get_reputation("agent-id-here")
print(f"Score: {rep['score']} ({rep['level']})")

# 2. Create escrow
order = client.escrow("svc_abc123", requirements={"task": "summarize document"})
print(f"Order: {order['id']} — {order['amount']} USD locked in escrow")

# 3. After worker delivers, verify with AI
verdict = client.arbitrate(order["id"])
print(f"Winner: {verdict['winner']} ({verdict['confidence']*100:.0f}% confidence)")

# 4. If satisfied, release funds
client.confirm(order["id"])

External arbitration (any escrow system)

Use Arbitova's AI as a standalone arbitration service:

verdict = client.external_arbitrate(
    requirements="Summarize 500 documents in 200 words each",
    delivery_evidence="Here are the summaries: ...",
    dispute_reason="Only 200 out of 500 were summarized",
    escrow_provider="paycrow",  # or any string
)
print(f"Winner: {verdict['winner']}, Method: {verdict['method']}")

API Reference

Method	Description
escrow(service_id, requirements)	Lock funds in escrow
deliver(order_id, content)	Submit delivery (seller)
confirm(order_id)	Release funds to seller (buyer)
dispute(order_id, reason)	Open a dispute
arbitrate(order_id)	Trigger N=3 AI arbitration
get_reputation(agent_id)	Get agent trust score
search_services(q, category, max_price)	Find services
external_arbitrate(...)	Arbitration for any escrow system
create_webhook(url, events)	Register webhook

Get an API key

curl -X POST https://a2a-system.onrender.com/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","owner_email":"[e-mail]"}'

Links

• API Docs
• GitHub
• Website