Get started with BUYR

Connect, configure your spending policy, and clear OFAC screening — all in under 10 minutes.

ConnectPolicyScreeningReady

Connect your wallet

Your AAIN will be assigned when you connect.

A full Ethereum address (42 chars) is recommended for OFAC screening.

B

BUYR

Active

Buy anything. Comply automatically. BUYR provisions wallets, enforces spending policies, and routes every payment through the Agentgorithm™ — so your agent never touches a compliance team.

@0xbuyrbuyr.base.eth0xbuyr.ioBuilt on Base

Token

$BUYR

ERC-20 on Base

Max Supply

10B

Emission-gated

Agent Skills

4

Pay, Discover, Budget, Wallet

API Endpoints

10

/buyr/v1/*

Capabilities

Wallet Provisioning

  • CDP Server Wallet v2 with programmable spending policies
  • Trust tiers: Starter, Standard, Premium, Enterprise
  • Per-category budget allocation (compute, data, API, model, agent)
  • Auto-approval thresholds from $0.10 to $100
  • Freeze, unfreeze, and close wallets on demand

Spending Policy Engine

  • Daily and monthly limits enforced in real-time
  • Per-transaction caps from $500 to $500K by tier
  • Per-seller spending limits and blocklist/allowlist
  • Multi-signature support for large transactions
  • Category-level budget tracking and alerts

Payment Authorization

  • Real-time policy enforcement before every payment
  • OFAC compliance screening via SAMUEL
  • EIP-3009 signature-based authorization
  • Atomic on-chain settlement on Base
  • Full transaction history with settlement tx hashes

Service Discovery

  • Multi-source search across A2A, AgentFacts, Bazaar, ERC-8004
  • Trust-ranked results by score, price, and compliance
  • Natural language service queries
  • Discovery caching with usage tracking
  • Cross-chain registry support

Agent Skills

Downloadable agent skills for managing crypto asset transactions. Install via npm install @shulam/sdk

create-buyr-wallet

Create a BUYR agent wallet with spending policies. Provisions a CDP wallet, activates skills, and sets default budget limits.

buyr-pay

Authorize and execute an x402 payment to a service endpoint. Handles the full payment flow: authorization, on-chain settlement, and response delivery.

buyr-discover

Search for x402-monetized services on the Shulam network. Returns trust-ranked results from A2A, AgentFacts, Bazaar, and ERC-8004.

buyr-budget

Get or update spending budget policies for a BUYR wallet. Supports per-category daily and monthly limits in atomic USDC.

API Reference

REST API at https://api.shulam.io/buyr/v1

Wallet Management

POST/walletsCreate wallet
GET/walletsList wallets
GET/wallets/:idGet wallet
DELETE/wallets/:idClose wallet
POST/wallets/:id/freezeFreeze wallet
POST/wallets/:id/unfreezeUnfreeze wallet

Policies & Authorization

GET/wallets/:id/policiesGet spending policy
PUT/wallets/:id/policiesUpdate spending policy
POST/authorizeAuthorize payment
GET/wallets/:id/transactionsList transactions

$BUYR Token

Token Details

Name
Shulam Buyer Token
Symbol
BUYR
Standard
ERC-20
Network
Base (Mainnet)
Max Supply
10,000,000,000
Decimals
18

Emission Model

  • Earned exclusively through x402 transactions — no presale, no VC allocation
  • Minting controlled by EmissionOracle smart contract (sole authorized minter)
  • Buyer interchange fee: 2–5 basis points on authorized spend
  • Volume-gated decay: emission rate decreases with cumulative network volume
  • Fixed MAX_SUPPLY — no inflation beyond 10B tokens
  • Burn function available — deflationary by design

Buyer Interchange Fees

Trust TierInterchange FeeDaily LimitMonthly Limit
Starter5 bps$1,000$10,000
Standard4 bps$10,000$100,000
Premium3 bps$100,000$1,000,000
Enterprise2 bps$1,000,000$10,000,000

The Four-Corners Model

BUYR is the issuer side of Shulam's four-corners payment network — like Visa for the agent economy.

Issuer

BUYR

Spending Policy

Network

Shulam

x402 Facilitator

Acquirer

SELLR

Payouts & Revenue

Give your agent a wallet

Provision a BUYR wallet with spending policies and start paying for services in the agent economy.