SDK Documentation

# Single-file install (no pip required)
curl -o gopi_client.py https://raw.githubusercontent.com/getgopi/sdk/main/gopi_sdk/client.py

// Single-file install (no npm required)
curl -o gopi-client.js https://raw.githubusercontent.com/getgopi/sdk/main/gopi-sdk-node/index.js

from gopi_sdk import GopiClient

client = GopiClient(
    api_key="gopi_sk_...",
    agent_id="your-agent-id",
)

# Track a payment
result = client.track_payment(amount=49.99, status="paid")
print(result)  # {"event_id": "...", "status": "paid", ...}

# Request a certificate (requires ≥3 autonomous payments)
cert = client.certify()
print(f"Score: {cert['score']}, Grade: {cert['grade']}, Confidence: {cert['confidence']}")

const { GopiClient } = require('gopi-sdk');

const client = new GopiClient(
    'gopi_sk_...',
    'your-agent-id',
);

// Track a payment
const result = await client.trackPayment({ amount: 49.99, status: 'paid' });
console.log(result);

// Request a certificate
const cert = await client.certify();
console.log(`Score: ${cert.score}, Grade: ${cert.grade}`);

client.track_payment(
    amount=49.99,
    currency="EUR",           # default
    status="paid",             # "paid"|"on_time"|"late"|"missed"|"disputed"
    payment_source="agent_wallet",  # default — agent paid autonomously
    is_autonomous=True,        # True = counted toward trust score
    date="2024-03-15T12:00:00Z",  # ISO 8601, default: now
)

profile = client.get_score()
# {
#   "gopi_id": "gopi_lch_a1b2c3d4",
#   "name": "My Finance Bot",
#   "certificate": {
#     "score": 87,
#     "grade": "B",
#     "confidence": "high",
#     "valid_until": "2024-06-15T00:00:00Z"
#   },
#   "payment_stats": {"total": 42, "autonomous": 38, "on_time": 36},
#   "badge_url": "https://api.getgopi.io/v1/public/gopi_lch_a1b2c3d4/badge.svg"
# }

cert = client.certify()
print(cert["score"])       # 0–100
print(cert["grade"])       # A+ / A / B / C / D / F
print(cert["confidence"])  # "low" (<5 payments), "medium" (5–20), "high" (>20)
print(cert["valid_until"]) # ISO 8601, 90 days from now

from langchain_openai import ChatOpenAI
from gopi_sdk.langchain import GopiCallbackHandler

handler = GopiCallbackHandler(
    api_key="gopi_sk_...",
    agent_id="your-agent-id",
    cost_per_1k_tokens=0.002,  # e.g. GPT-4o-mini
)

llm = ChatOpenAI(
    model="gpt-4o-mini",
    callbacks=[handler],
)

# Every LLM call now automatically tracks a payment event
response = llm.invoke("Summarize the quarterly report.")

await client.trackPayment({
    amount: 49.99,
    currency: 'EUR',
    status: 'paid',          // 'paid'|'on_time'|'late'|'missed'|'disputed'
    paymentSource: 'agent_wallet',
    isAutonomous: true,
    date: new Date().toISOString(),
});

const profile = await client.getScore();
console.log(profile.certificate?.score);  // 87
console.log(profile.badge_url);           // embed in README or website

const cert = await client.certify();
console.log(`${cert.grade} — ${cert.score}/100 (${cert.confidence} confidence)`);

from gopi_sdk import GopiClient, GopiError

try:
    cert = client.certify()
except GopiError as e:
    print(e.status_code)  # HTTP status code
    print(e.message)      # API error message
    if e.status_code == 402:
        print("Upgrade to Basic or Professional to certify.")
    elif e.status_code == 429:
        print("Rate limit hit — wait before retrying.")

const { GopiClient, GopiError } = require('gopi-sdk');

try {
    const cert = await client.certify();
} catch (e) {
    if (e instanceof GopiError) {
        console.error(e.statusCode, e.gopiMessage);
    }
}

curl -X POST https://api.getgopi.io/v1/payment-events \
  -H "X-API-Key: gopi_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "my-finance-bot-abc12345",
    "amount": 49.99,
    "currency": "EUR",
    "status": "paid",
    "payment_source": "agent_wallet",
    "is_autonomous": true,
    "due_at": "2024-03-15T12:00:00Z"
  }'