Use Case

Your agent consumes APIs.
Oris handles the bill.

Autonomous agents call external APIs thousands of times per day. Each call costs a fraction of a cent. Traditional payment infrastructure cannot process this volume at this price point. Oris micropayment channels batch thousands of sub-cent payments into periodic on-chain settlements. Your agent pays per call. The provider receives payment per call. The on-chain cost stays minimal.

warning

The API Consumption Problem

An AI research agent calls a market data API 50,000 times per day at $0.002 per call. That is $100 per day in API costs spread across 50,000 individual transactions. Processing each call as a separate on-chain payment would cost more in gas than the API call itself. Credit card processors do not support sub-cent transactions. Traditional invoicing creates reconciliation overhead. The agent needs a payment method that matches the granularity of its consumption.

Solution

How Oris Solves API Billing

1

Open a Channel

The developer configures a micropayment channel between the agent and the API provider. The channel allocates a budget from the agent's wallet. One on-chain transaction opens the channel.

2

Pay Per Call

Each API call triggers a micropayment through the channel. The payment updates the channel balance in memory. No on-chain transaction occurs per call. The agent pays. The provider tracks the balance.

3

Settle Periodically

The channel settles periodically (hourly, daily, or when the budget is exhausted). A single on-chain transaction captures all accumulated micropayments. The API provider receives the total amount minus settlement gas costs.

Patterns

Supported Payment Patterns

touch_app

Pay-Per-Call

Fixed price per API call. The agent pays $0.003 per request. Oris tracks the running total and settles on schedule. The simplest model for predictable pricing.

Example
10,000 calls x $0.003 = $30.00
Settlement: 1 on-chain tx
speed

Metered Usage

Variable pricing based on response size, compute time, or data volume. The provider reports usage. Oris calculates the cost and deducts from the channel automatically.

Example
$0.001/KB response size
Variable cost per call
data_usage

Subscription with Overage

Base monthly allocation with per-call pricing above the limit. Oris manages the allocation tracking and overage billing automatically. No manual reconciliation required.

Example
$50/mo for 25K calls
$0.003/call overage
Integration

Micropayments in Code

api_consumption.py

# Configure API consumption for an agent
channel = oris.micropayments.open(
    agent_id="agent_researcher",
    provider="0x7f3a...9c2d",  # API provider wallet
    budget=100.00,              # $100 daily budget
    settlement="hourly",
    chain="base"
)

# Agent calls the API (payment happens automatically)
response = agent.call_api(
    url="https://api.datavendor.com/market-data",
    payment_channel=channel.id
)
# Oris deducts $0.002 from the channel

# Check consumption
print(channel.spent)       # $47.30
print(channel.remaining)   # $52.70
print(channel.call_count)  # 23,650
        
Economics

The Cost Difference

50,000 API calls per day at $0.002 per call on Base L2.

close

Without Oris

On-chain transactions 50,000
Gas per transaction ~$0.001
Total gas cost $50.00
API costs $100.00
Daily Total $150.00
check_circle

With Oris

On-chain transactions 1
Gas per settlement ~$0.001
Total gas cost $0.001
API costs $100.00
Daily Total $100.001
savings 33% cost reduction. $49.999 saved per day. $18,250 saved per year.

Open your first micropayment channel.

Configure a channel, connect your agent, and start paying for API calls at sub-cent granularity. Settlement happens automatically.