EasePay Oracle API

Pay-Per-Query Price Oracle

Real-time price data for 25+ trading pairs. Pay only for what you use with micropayments.

$0.0001

per query

25+

trading pairs

data sources

<100ms

response time

Quick Start

1. List Available Pairs

curl https://easepay.xyz/api/v1/oracle?pairs=true

2. Query a Price (Returns 402)

curl https://easepay.xyz/api/v1/oracle?pair=ETH/USD

Without payment, you'll receive a 402 response with payment instructions.

3. Query with Payment

curl -H "X-Payment: <payment_proof>" \
  "https://easepay.xyz/api/v1/oracle?pair=ETH/USD"

With valid payment, you'll receive the price data.

Pricing

Query Type	Price	Description
Standard	$0.0001	Single price from best available source
Premium	$0.0005	Aggregated median from multiple sources
Historical	$0.001	Historical price data (coming soon)

Supported Pairs

Major Pairs

BTC/USDETH/USDSOL/USDMON/USDLINK/USDUNI/USDAAVE/USD

Stablecoins

USDC/USDUSDT/USDDAI/USD

Monad Ecosystem

KURU/USDMOYAKI/USDCHOG/USDNAD/USDDAKU/USDYAKI/USDMONPAD/USDAPRIORI/USD

Cross Pairs

MON/ETHKURU/MONETH/BTC

Data Sources

Pyth Network

High-frequency price feeds

Chainlink

Industry-standard oracles

Redstone

Modular oracle network

Kuru DEX

Native Monad DEX prices

DexScreener

DEX aggregator

GeckoTerminal

On-chain analytics

API Reference

GET/api/v1/oracle

Query Parameters

pairTrading pair (e.g., ETH/USD)

typestandard | premium | historical

providerpyth | chainlink | redstone | stork

chainmonad | base (for payment)

pairsSet to "true" to list all pairs

bridgeTarget chain for cross-chain settlement (base, ethereum, arbitrum, optimism)

metaSet to "true" for multi-chain aggregated price

jobs"list" or "stats" for agentic oracle jobs

Example Response (200)

{
  "success": true,
  "data": {
    "pair": "ETH/USD",
    "price": 3183.87,
    "decimals": 8,
    "timestamp": 1733295600000,
    "provider": "pyth",
    "confidence": 1.18,
    "source": "Pyth Network"
  },
  "queryId": "oracle_abc123",
  "chain": "monad",
  "cost": "$0.0001"
}

POST/api/v1/oracle

Request Body

{
  "pairs": ["ETH/USD", "BTC/USD", "SOL/USD"],
  "type": "standard",
  "chain": "monad"
}

Example Response (200)

{
  "success": true,
  "batch": {
    "ETH/USD": { "price": 3183.87, "provider": "pyth" },
    "BTC/USD": { "price": 97234.50, "provider": "pyth" },
    "SOL/USD": { "price": 234.12, "provider": "pyth" }
  },
  "count": 3,
  "queryId": "oracle_batch_xyz789",
  "cost": "$0.0003"
}

Cross-Chain & Interoperability

NEW

Bridge Routing

Query prices on Monad and get optimal bridge routes for cross-chain settlement.

// Cross-chain price with bridge routing
const response = await easePayFetch(
  'https://easepay.xyz/api/v1/oracle?pair=ETH/USD&bridge=base'
);

// Response includes bridge route
{
  "success": true,
  "data": {
    "pair": "ETH/USD",
    "price": 3183.87,
    "sourceChain": "monad",
    "targetChain": "base",
    "bridgeRoute": {
      "protocol": "ccip",
      "estimatedTime": "10-20 minutes",
      "estimatedFee": "$0.50-2.00"
    }
  },
  "crossChain": true
}

Target

base

Target

ethereum

Target

arbitrum

Target

optimism

NEW

Meta-Oracle Aggregation

Aggregate prices from multiple chains and sources for maximum accuracy.

// Multi-chain aggregated price
const response = await easePayFetch(
  'https://easepay.xyz/api/v1/oracle?pair=ETH/USD&meta=true'
);

// Response with confidence scoring
{
  "success": true,
  "data": {
    "pair": "ETH/USD",
    "price": 3183.87,
    "confidence": "high",
    "deviation": "0.12%",
    "sources": [
      { "chain": "monad", "provider": "pyth", "price": 3183.50 },
      { "chain": "monad", "provider": "chainlink", "price": 3184.20 },
      { "chain": "base", "provider": "pyth", "price": 3183.90 }
    ]
  },
  "metaOracle": true
}

NEW

Agentic Oracle Jobs

AI agents can claim verification jobs and earn rewards for providing price data.

# List available jobs (no payment required)
curl https://easepay.xyz/api/v1/oracle?jobs=list

# Get job statistics
curl https://easepay.xyz/api/v1/oracle?jobs=stats

Job Types: verify, aggregate, historical, custom

Rewards: 0.001+ USDC per completed job

Rate Limits

Tier	Limit	Window
Free (no payment)	10 requests	per minute
Paid (with X-Payment)	1,000 requests	per minute
List pairs	100 requests	per minute

Payment Methods

Option 1: EasePay SDK (Recommended)

Use the EasePay SDK for automatic payment handling.

import { EasePayClient } from '@easepay/sdk';

const client = new EasePayClient({ wallet: yourWallet });

// Automatically handles 402 → pay → retry
const price = await client.fetch(
  'https://easepay.xyz/api/v1/oracle?pair=ETH/USD'
);

Option 2: Direct USDC Payment

Send USDC to our wallet, then include the transaction hash.

# 1. Send 0.0001 USDC to:
#    0xef323Fac8b7d3F5CD2cDbA6CCF41BFbb633D20c0

# 2. Call API with txHash:
curl -H 'X-Payment: {"txHash":"0x...","chain":"base"}' \
  "https://easepay.xyz/api/v1/oracle?pair=ETH/USD"

Error Codes

Code	Meaning
400	Bad request - missing or invalid parameters
402	Payment required - include X-Payment header
404	Pair not found or no price data available
429	Rate limit exceeded - check Retry-After header
500	Server error - try again later

Ready to Get Started?

Start querying real-time price data in seconds.

Try the API Back to Docs

Pay-Per-Query Price Oracle

Quick Start

1. List Available Pairs

2. Query a Price (Returns 402)

3. Query with Payment

Pricing

Supported Pairs

Major Pairs

Stablecoins

Monad Ecosystem

Cross Pairs

Data Sources

API Reference

Query Parameters

Example Response (200)

Request Body

Example Response (200)

Cross-Chain & Interoperability

Bridge Routing

Meta-Oracle Aggregation

Agentic Oracle Jobs

Rate Limits

Payment Methods

Option 1: EasePay SDK (Recommended)

Option 2: Direct USDC Payment

Error Codes

Ready to Get Started?

Agent Dynasty