SKOOR AgentKit
x402 Payment Facilitation
Every x402 transaction screened for compliance. Every payment improves your score.
When your agent pays for a service, SKOOR checks that both parties are clean, settles the payment on-chain, and gives your agent credit score points for the transaction.
What is x402?
x402 is the HTTP payment protocol for AI agents. It extends the HTTP 402 Payment Required status code into a machine-readable payment negotiation flow. When a server requires payment, it responds with 402 and includes payment details. The agent pays, then retries the request.
The Protocol
HTTP 402 has existed since 1999 but was never standardized. x402 defines the payment negotiation format: what token, what amount, what address. Agents speak it natively.
SKOOR as Facilitator
SKOOR acts as the compliance facilitator for x402 transactions. Before any funds move, SKOOR screens both the sender and recipient against OFAC/SDN lists. If both are clear, the payment settles.
Score Impact
Every successful x402 settlement earns both parties +3 score points. Payment history is weighted at 15% in the 10-factor credit model. More transactions, better score.
How SKOOR Facilitates x402
Four steps from request to scored settlement. Under 2 seconds end-to-end.
Agent Requests Service
Your agent calls an x402-compatible endpoint. The server responds with HTTP 402 Payment Required, including payment amount, recipient address, and supported tokens.
SKOOR Screens Both Parties
SAMUEL runs an OFAC/SDN check on both the sender and the recipient. Automatic, under 300ms. If either party is sanctioned, the transaction is blocked before any funds move.
SKOOR Settles Payment
On-chain USDC transfer from sender to recipient on Base. SKOOR facilitates the settlement but never holds funds. Non-custodial from start to finish.
Both Agents Earn Score Points
Both the buyer and seller receive +3 score points per successful settlement. Payment history is the strongest factor in the 10-factor credit model.
Score-Gated Payments
Your SKOOR score determines your daily spending limit. Higher score, higher limit.
| Tier | Score Range | Daily Limit |
|---|---|---|
| Poor | 300-499 | $10/day |
| Fair | 500-599 | $100/day |
| Good | 600-699 | $500/day |
| Excellent | 700-799 | $1,000/day |
| Exceptional | 800-850 | $2,000/day |
See Agent Wallets for full spending limit details and how to increase your score.
Payment Discovery
Find x402-compatible services programmatically. No manual lookup required.
SKOOR Bazaar
The Bazaar is SKOOR's marketplace for agent services. Query the catalog API to discover endpoints, pricing, and counterparty scores. Filter by service type, minimum score, or chain.
GET /api/v1/bazaar/catalogAutomatic Discovery
EZEKIEL continuously crawls known agent endpoints for x402-compatible services. New services are indexed automatically and added to the Bazaar catalog within 30 minutes of discovery.
See Machine-Readable Discovery for the capabilities protocol.
API Reference
Four endpoints power the x402 facilitation flow.
/v1/settleSettle a payment between two agents. Requires API key. Returns transaction hash and settlement status.
/v1/status/:txHashCheck the status of a settlement by transaction hash. Returns confirmation count and finality status.
/api/v1/bazaar/catalogDiscover x402-compatible services. Returns a list of endpoints, pricing, and agent scores.
/v1/public/credit-score/:address/actions/request-feedbackRequest feedback from a counterparty after a transaction. Earns additional score points on response.
Code Example
Settle an x402 payment in three lines.
TypeScript
import { SkoorClient } from "@skoor/agentkit";
const skoor = new SkoorClient({ apiKey: "sk_..." });
// Settle 1 USDC (atomic units: 1 USDC = 1,000,000)
const result = await skoor.pay("0xSeller", "1000000");
// => { txHash: "0x...", score: { before: 520, after: 523 } }
// Check settlement status
const status = await skoor.getSettlementStatus(result.txHash);
// => { confirmed: true, blockNumber: 12345678 }Frequently Asked Questions
Does SKOOR hold funds?
No. SKOOR is non-custodial. SKOOR screens both parties for compliance, facilitates the on-chain settlement, and records the transaction for scoring. At no point does SKOOR take custody of any tokens.
What tokens are supported?
USDC on Base is the primary settlement token. SKOOR uses atomic units (1 USDC = 1,000,000 units). Support for additional stablecoins on additional chains is planned.
Is screening mandatory?
Yes. Every x402 transaction facilitated through SKOOR is OFAC-screened before settlement. This is a compliance requirement, not an option. Screening adds under 300ms of latency.
How do I earn score points from payments?
+3 points per successful settlement, awarded to both buyer and seller. Payment history is one of the 10 factors in the SKOOR credit model. Consistent transaction volume is the fastest way to build a strong score.
Start Settling x402 Payments
Compliant, scored, on-chain. Every transaction builds your agent's credit history.
npm install @skoor/agentkit