ChainRay logoChainRay
Menu
API docsOpenAPIllms.txtstatusAbout
Connect MCP
01 / INTERFACE REFERENCE

Give an agent a clear contract to use.

Read the API as a contract: prices, inputs, request examples, response shapes, and supported network behavior in one place. Every paid call settles through x402.

Connect MCP OpenAPI explorer
Base URLhttps://chainray.onlineHTTPS / public edge
Payment boundaryx402 / USDC on BaseNo API key required
Agent transport79 MCP toolsStreamable HTTP + legacy SSE
Public agent discovery

Identity, skills, and a clear API map.

These free resources describe ChainRay and guide agents to existing capabilities. They do not add paid APIs or require an account. Route coverage and available evidence still depend on the selected network.

Agent Card

Service identity and published capabilities

/.well-known/agent-card.json
raw
Agent Skills

Five workflow guides with content hashes

/.well-known/agent-skills/index.json
raw
API Catalog

Links to API contracts, transport, and status

/.well-known/api-catalog
raw
AI Catalog

Capability guides and representative queries

/.well-known/ai-catalog.json
raw
MCP Capability Map

Complete mapping between MCP tools and HTTP capabilities

/.well-known/mcp-capabilities.json
raw

Market Data10 route entries

GET/price/{token}Get real-time token price from on-chain DEX pools (Uniswap V3), enriched with CoinGecko market data and DeFi Llama.$0.002

Get real-time token price from on-chain DEX pools (Uniswap V3), enriched with CoinGecko market data and DeFi Llama.

Parameters
chainquery / Target blockchain. Native-asset only on: monad, tempo, megaeth, arc, plasma, katana, robinhood, pharos, hyperevm. · default: base
tokenpath / string · required
Request
curl "https://chainray.online/price/ETH?chain=base"
Example response
{
  "token": "ETH",
  "priceUsd": 3245.67,
  "source": "Uniswap V3 WETH/USDC",
  "chain": "base",
  "confidence": "high",
  "marketCap": "$390.0B",
  "volume24h": "$12.3B",
  "priceChange24h": "-1.25%",
  "sources": [
    "on-chain DEX",
    "DeFi Llama",
    "CoinGecko"
  ]
}
GET/trending-tokensGet currently trending tokens by volume and price movement.$0.007

Get currently trending tokens by volume and price movement.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/trending-tokens?chain=base"
Example response
{
  "chain": "base",
  "tokens": [
    {
      "symbol": "DEGEN",
      "priceUsd": 0.012,
      "priceChange24h": "+15.3%",
      "volume24h": 5200000
    }
  ]
}
GET/dex-trades/{pool}Get recent DEX trades for a token pair.$0.012

Get recent DEX trades for a token pair.

Parameters
chainquery / EVM chain only · default: base
poolpath / pool (hex for EVM, base58 for Solana) · required
limitquery / integer · default: 20
Request
curl "https://chainray.online/dex-trades/0x<pool>?chain=base"
Example response
{
  "chain": "base",
  "trades": [],
  "count": 0
}
GET/new-pairsDiscover newly created liquidity pools and trading pairs.$0.012

Discover newly created liquidity pools and trading pairs.

Parameters
chainquery / EVM chain only · default: base
hoursquery / Lookback period (1-168h) · default: 24
withRiskquery / Include token risk scoring · default: false
Request
curl "https://chainray.online/new-pairs?chain=base"
Example response
{
  "chain": "base",
  "pairs": [],
  "count": 0
}
GET/sentiment/{token}NLP-based token sentiment analysis from news and social media (via CryptoCompare).$0.012

NLP-based token sentiment analysis from news and social media (via CryptoCompare).

Parameters
chainquery / Target blockchain · default: base
tokenpath / string · required
Request
curl "https://chainray.online/sentiment?token=ETH"
Example response
{
  "token": "ETH",
  "sentiment": "bullish",
  "score": 0.72,
  "sources": [
    "news",
    "social"
  ],
  "chain": "base"
}
GET/kol-tradesTrack KOL (Key Opinion Leader) trading activity and patterns.$0.05

Track KOL (Key Opinion Leader) trading activity and patterns.

Parameters
chainquery / EVM chain only · default: base
hoursquery / Lookback period (1-168h) · default: 24
limitquery / Max trades to return · default: 20
Request
curl "https://chainray.online/kol-trades?chain=base"
Example response
{
  "chain": "base",
  "trades": [],
  "kolCount": 0
}
GET/token-screenerAdvanced token screening with multi-factor analysis.$0.025

Advanced token screening with multi-factor analysis.

Parameters
chainquery / EVM chain only · default: base
maxRiskquery / integer · default: 100
minPricequery / number · default: 0
limitquery / integer · default: 10
Request
curl "https://chainray.online/token-screener?chain=base"
Example response
{
  "chain": "base",
  "tokens": [],
  "filters": {}
}
GET/market-overviewComprehensive market overview — ETH price, gas, top movers, DeFi TVL. Aggregates multiple data sources.$0.05

Comprehensive market overview — ETH price, gas, top movers, DeFi TVL. Aggregates multiple data sources.

ParametersNo parameters. The endpoint is ready to call as published.
Request
curl "https://chainray.online/market-overview?chain=base"
Example response
{
  "chain": "base",
  "ethPrice": 3245.67,
  "gas": {},
  "topMovers": [],
  "defiTvl": "$45B",
  "timestamp": 1713000000000
}
GET/capital-flow-radarCapital flow analysis across chains and protocols.$0.05

Capital flow analysis across chains and protocols.

ParametersNo parameters. The endpoint is ready to call as published.
Request
curl "https://chainray.online/capital-flow-radar?chain=base"
Example response
{
  "chain": "base",
  "inflows": {},
  "outflows": {},
  "netFlow": 0
}
GET/market-pulseReal-time market pulse combining price, volume, sentiment, and whale activity.$0.05

Real-time market pulse combining price, volume, sentiment, and whale activity.

ParametersNo parameters. The endpoint is ready to call as published.
Request
curl "https://chainray.online/market-pulse?chain=base"
Example response
{
  "chain": "base",
  "pulse": {},
  "sentiment": "neutral",
  "whaleActivity": "low"
}

Gas & Fees4 route entries

GET/gas-trackerCurrent gas prices with congestion level and trend analysis.$0.002

Current gas prices with congestion level and trend analysis.

Parameters
chainquery / Target blockchain · default: base
Request
curl "https://chainray.online/gas-tracker?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "current": {
    "baseFee": 12.5,
    "priorityFee": 1.2,
    "unit": "gwei"
  },
  "trend": "decreasing",
  "congestion": "low",
  "timestamp": 1713000000000
}
GET/gas-historyHistorical gas price data over recent blocks.$0.002

Historical gas price data over recent blocks.

Parameters
chainquery / Target blockchain · default: base
Request
curl "https://chainray.online/gas-history?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "blocks": 20,
  "history": [
    {
      "blockNumber": 19500000,
      "baseFee": 12.3
    }
  ],
  "avgBaseFee": 13.2
}
GET/gas-predictShort-term gas price prediction based on recent block trends.$0.007

Short-term gas price prediction based on recent block trends.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/gas-predict?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "prediction": {
    "next5min": 14.2,
    "next1hr": 12.8
  },
  "confidence": "medium",
  "trend": "decreasing"
}
GET/gas-optimizationGet gas optimization recommendations for the current network conditions.$0.007

Get gas optimization recommendations for the current network conditions.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/gas-optimization?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "recommendations": [],
  "optimalTiming": "now"
}

Token Data3 route entries

GET/token-supply/{address}Get total and circulating supply of an ERC-20 token.$0.002

Get total and circulating supply of an ERC-20 token.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/token-supply/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?chain=base"
Example response
{
  "token": "USDC",
  "totalSupply": "4363039207.94",
  "decimals": 6,
  "chain": "base"
}
GET/token-holders/{address}Get top holders of an ERC-20 token.$0.007

Get top holders of an ERC-20 token.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
limitquery / integer · default: 20
Request
curl "https://chainray.online/token-holders?address=0x...&chain=base"
Example response
{
  "token": "0x...",
  "holders": [],
  "totalHolders": 0,
  "chain": "base"
}
GET/token-unlock/{address}Track token vesting and unlock schedules.$0.025

Track token vesting and unlock schedules.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/token-unlock?address=0x...&chain=ethereum"
Example response
{
  "token": "0x...",
  "unlocks": [],
  "chain": "ethereum"
}

Address Intelligence7 route entries

GET/address-labels/{address}Get known labels for an address (exchange, DEX, contract type).$0.002

Get known labels for an address (exchange, DEX, contract type).

Parameters
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/address-labels/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?chain=ethereum"
Example response
{
  "address": "0xA0b8...",
  "labels": [
    {
      "name": "USDC",
      "category": "stablecoin",
      "confidence": 0.99
    }
  ],
  "chain": "ethereum"
}
GET/recent-interactions/{address}Get recent transaction interactions for an address.$0.007

Get recent transaction interactions for an address.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/recent-interactions?address=0x...&chain=base"
Example response
{
  "address": "0x...",
  "interactions": [],
  "chain": "base"
}
GET/wallet-profile/{address}Comprehensive wallet analysis — balances, activity age, transaction patterns.$0.025

Comprehensive wallet analysis — balances, activity age, transaction patterns.

Parameters
chainquery / Target blockchain · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/wallet-profile/0x<address>?chain=base"
Example response
{
  "address": "0x...",
  "balance": {},
  "txCount": 0,
  "firstSeen": null,
  "chain": "base"
}
GET/smart-moneyTrack smart money wallet movements and patterns.$0.025

Track smart money wallet movements and patterns.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/smart-money?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "wallets": [],
  "totalTracked": 0
}
GET/portfolio-analyze/{address}Analyze a wallet's portfolio composition and performance.$0.025

Analyze a wallet's portfolio composition and performance.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/portfolio-analyze?address=0x...&chain=base"
Example response
{
  "address": "0x...",
  "totalValueUsd": 0,
  "assets": [],
  "chain": "base"
}
GET/credit-score/{address}On-chain credit score for a wallet address (10-factor model).$0.025

On-chain credit score for a wallet address (10-factor model).

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/credit-score?address=0x...&chain=base"
Example response
{
  "address": "0x...",
  "score": 650,
  "grade": "B",
  "factors": {},
  "chain": "base"
}
GET/address-report/{address}Comprehensive address report combining wallet profile, risk, labels, and activity.$0.05

Comprehensive address report combining wallet profile, risk, labels, and activity.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/address-report/0x...?chain=base"
Example response
{
  "address": "0x...",
  "profile": {},
  "risk": {},
  "labels": [],
  "chain": "base"
}

Security9 route entries

GET/contract-verify/{address}Check if a contract address has verified source code.$0.002

Check if a contract address has verified source code.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/contract-verify?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&chain=base"
Example response
{
  "address": "0x8335...",
  "verified": true,
  "chain": "base"
}
GET/token-risk/{address}Token risk assessment — checks proxy contracts, verified source, ownership, and honeypot indicators.$0.012

Token risk assessment — checks proxy contracts, verified source, ownership, and honeypot indicators.

Parameters
chainquery / Target blockchain · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/token-risk?address=0x...&chain=base"
Example response
{
  "address": "0x...",
  "riskScore": 25,
  "isProxy": false,
  "isVerified": true,
  "ownershipRenounced": true,
  "chain": "base"
}
GET/token-approval/{address}Check token approval/allowance status for an address.$0.012

Check token approval/allowance status for an address.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/token-approval?address=0x...&chain=base"
Example response
{
  "address": "0x...",
  "approvals": [],
  "riskyApprovals": 0,
  "chain": "base"
}
GET/multi-sig/{address}Analyze multi-signature wallet configuration.$0.012

Analyze multi-signature wallet configuration.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/multi-sig?address=0x...&chain=ethereum"
Example response
{
  "address": "0x...",
  "isMultiSig": false,
  "chain": "ethereum"
}
GET/contract-scan/{address}Deep contract safety scan — bytecode analysis, proxy detection, storage inspection.$0.025

Deep contract safety scan — bytecode analysis, proxy detection, storage inspection.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/contract-scan/0x<address>?chain=base"
Example response
{
  "address": "0x...",
  "isContract": true,
  "isProxy": false,
  "verified": true,
  "chain": "base"
}
GET/mev-detect/{txHash}Post-transaction sandwich attack detection. Analyzes surrounding transactions in the same block to identify MEV patterns.$0.025

Post-transaction sandwich attack detection. Analyzes surrounding transactions in the same block to identify MEV patterns.

Parameters
chainquery / EVM chain only · default: base
txHashpath / string · required
Request
curl "https://chainray.online/mev-detect/0x<txHash>?chain=base"
Example response
{
  "txHash": "0x...",
  "blockNumber": 12345,
  "mevDetected": false,
  "sandwichAttacks": [],
  "riskLevel": "NONE",
  "note": "Post-transaction analysis only"
}
GET/risk-dashboard/{address}Comprehensive risk dashboard for an address.$0.025

Comprehensive risk dashboard for an address.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/risk-dashboard?address=0x...&chain=base"
Example response
{
  "address": "0x...",
  "overallRisk": "low",
  "categories": {},
  "chain": "base"
}
GET/sandwich-scanner/{address}Scan an address's recent transactions for sandwich attack patterns.$0.025

Scan an address's recent transactions for sandwich attack patterns.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/sandwich-scanner?address=0x...&chain=base"
Example response
{
  "address": "0x...",
  "sandwichesDetected": 0,
  "transactions": [],
  "chain": "base"
}
GET/mev-shieldPre-trade MEV risk assessment (heuristic model). Evaluates sandwich attack risk based on trade size, gas conditions, and chain characteristics. Note: does NOT read mempool.$0.05

Pre-trade MEV risk assessment (heuristic model). Evaluates sandwich attack risk based on trade size, gas conditions, and chain characteristics. Note: does NOT read mempool.

Parameters
chainquery / Target blockchain · default: base
actionquery / string · default: swap
tokenInquery / string
amountquery / string
Request
curl "https://chainray.online/mev-shield?action=swap&tokenIn=USDC&tokenOut=ETH&amountUsd=5000&chain=ethereum"
Example response
{
  "oracleType": "mev-shield",
  "risk": {
    "sandwichRisk": 0.35,
    "riskLevel": "medium"
  },
  "recommendation": "proceed_with_caution",
  "recommendedSlippage": 0.5,
  "limitations": [
    "No mempool visibility",
    "Statistical estimate"
  ]
}

DeFi16 route entries

GET/governanceGet governance information for a protocol.$0.007

Get governance information for a protocol.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/governance?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "proposals": [],
  "activeVotes": 0
}
GET/stablecoin-supplyTrack stablecoin supply across the chain.$0.007

Track stablecoin supply across the chain.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/stablecoin-supply?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "stablecoins": [
    {
      "symbol": "USDC",
      "supply": "42B"
    }
  ]
}
GET/solver-feedERC-7683 cross-chain intent profitability feed.$0.007

ERC-7683 cross-chain intent profitability feed.

Parameters
fromquery / string · default: base
toquery / string · default: arbitrum
amountquery / string · default: 1000
Request
curl "https://chainray.online/solver-feed?from=base&to=arbitrum&amount=1000"
Example response
{
  "chain": "base",
  "intents": [],
  "timestamp": 1713000000000
}
GET/defi-yieldsCurrent DeFi yield opportunities across protocols.$0.012

Current DeFi yield opportunities across protocols.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/defi-yields?chain=base"
Example response
{
  "chain": "base",
  "yields": [
    {
      "protocol": "Aave",
      "apy": "4.2%",
      "token": "USDC"
    }
  ]
}
GET/defi-compareCompare DeFi protocol metrics side by side.$0.012

Compare DeFi protocol metrics side by side.

Parameters
chainquery / Target blockchain · default: base
Request
curl "https://chainray.online/defi-compare?chain=base"
Example response
{
  "chain": "base",
  "protocols": []
}
GET/stablecoin-monitorMonitor stablecoin peg health and deviations.$0.012

Monitor stablecoin peg health and deviations.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/stablecoin-monitor?chain=base"
Example response
{
  "chain": "base",
  "stablecoins": [
    {
      "symbol": "USDC",
      "peg": 1.0001,
      "deviation": "0.01%"
    }
  ]
}
GET/protocol-tvlGet Total Value Locked (TVL) data for DeFi protocols via DeFi Llama.$0.012

Get Total Value Locked (TVL) data for DeFi protocols via DeFi Llama.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/protocol-tvl?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "protocols": [
    {
      "name": "Aave",
      "tvlUsd": 12500000000
    }
  ],
  "totalTvl": "$45.2B"
}
GET/yield-farmingActive yield farming opportunities.$0.012

Active yield farming opportunities.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/yield-farming?chain=base"
Example response
{
  "chain": "base",
  "farms": []
}
GET/flashloan-monitorMonitor flashloan activity on the chain.$0.012

Monitor flashloan activity on the chain.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/flashloan-monitor?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "recentFlashloans": [],
  "count": 0
}
GET/liquidation-alertsDeFi lending protocol liquidation alerts.$0.012

DeFi lending protocol liquidation alerts.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/liquidation-alerts?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "alerts": [],
  "atRiskPositions": 0
}
GET/liquidity-depth/{tokenA}/{tokenB}Analyze liquidity depth and concentration for a token.$0.025

Analyze liquidity depth and concentration for a token.

Parameters
chainquery / EVM chain only · default: base
tokenApath / tokenA (hex for EVM, base58 for Solana) · required
tokenBpath / tokenB (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/liquidity-depth/WETH/USDC?chain=base"
Example response
{
  "chain": "base",
  "depth": {},
  "pools": []
}
GET/protocol-healthHealth metrics for DeFi protocols.$0.025

Health metrics for DeFi protocols.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/protocol-health?chain=base"
Example response
{
  "chain": "base",
  "protocols": [],
  "healthScore": 0
}
GET/yield-aggregatorAggregated yield opportunities across protocols.$0.025

Aggregated yield opportunities across protocols.

ParametersNo parameters. The endpoint is ready to call as published.
Request
curl "https://chainray.online/yield-aggregator?chain=base"
Example response
{
  "chain": "base",
  "opportunities": [],
  "bestApy": null
}
GET/defi-opportunityCurated DeFi opportunities based on current market conditions.$0.025

Curated DeFi opportunities based on current market conditions.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/defi-opportunity?chain=base"
Example response
{
  "chain": "base",
  "opportunities": []
}
GET/yield-optimizerOptimized yield strategy recommendations.$0.05

Optimized yield strategy recommendations.

Parameters
minTvlquery / Minimum TVL filter in USD · default: 1000000
Request
curl "https://chainray.online/yield-optimizer?chain=base"
Example response
{
  "chain": "base",
  "strategies": [],
  "bestStrategy": null
}
GET/impermanent-lossCalculate impermanent loss for a liquidity position.$0.012

Calculate impermanent loss for a liquidity position.

Parameters
chainquery / Target blockchain · default: base
entryPricequery / Token price at LP entry · required
currentPricequery / Current token price · required
Request
curl "https://chainray.online/impermanent-loss?chain=base&entryPrice=1&currentPrice=1.1"
Example response
{
  "chain": "base",
  "ilPct": 0,
  "analysis": {}
}

Whale Tracking2 route entries

GET/whale-alertsMonitor large token transfers (USDC, WETH, USDT, DAI) with exchange classification.$0.007

Monitor large token transfers (USDC, WETH, USDT, DAI) with exchange classification.

Parameters
chainquery / Target blockchain · default: base
hoursquery / integer · default: 6
minAmountquery / integer · default: 50000
Request
curl "https://chainray.online/whale-alerts?chain=ethereum&minAmount=100000"
Example response
{
  "chain": "ethereum",
  "totalAlerts": 5,
  "alerts": [
    {
      "txHash": "0x...",
      "from": "0x...",
      "to": "0x...",
      "token": "USDC",
      "amount": 500000,
      "usdValue": 500000,
      "direction": "exchange_deposit"
    }
  ]
}
GET/whale-tracker/{address}Track specific whale wallet activity and movements.$0.025

Track specific whale wallet activity and movements.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/whale-tracker?address=0x...&chain=ethereum"
Example response
{
  "address": "0x...",
  "movements": [],
  "chain": "ethereum"
}

Cross-Chain4 route entries

GET/bridge-monitorMonitor cross-chain bridge activity and volumes.$0.007

Monitor cross-chain bridge activity and volumes.

Parameters
chainquery / EVM chain only · default: base
minAmountquery / integer · default: 50000
Request
curl "https://chainray.online/bridge-monitor?chain=base"
Example response
{
  "chain": "base",
  "bridges": [],
  "totalVolume24h": 0
}
GET/chain-compareCompare metrics across multiple chains.$0.025

Compare metrics across multiple chains.

Parameters
chainsquery / Comma-separated chain list
Request
curl "https://chainray.online/chain-compare"
Example response
{
  "chains": [],
  "comparison": {}
}
GET/bridge-flowTrack cross-chain bridge flow data.$0.025

Track cross-chain bridge flow data.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/bridge-flow?chain=base"
Example response
{
  "chain": "base",
  "inflows": 0,
  "outflows": 0
}
GET/cross-chain/{address}Cross-chain activity analysis for an address.$0.025

Cross-chain activity analysis for an address.

Parameters
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/cross-chain?address=0x..."
Example response
{
  "address": "0x...",
  "chainsActive": [],
  "totalChains": 0
}

NFT4 route entries

GET/nft/{contract}Get NFT collection data and token metadata.$0.002

Get NFT collection data and token metadata.

Parameters
chainquery / EVM chain only · default: base
contractpath / contract (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/nft?address=0x...&chain=ethereum"
Example response
{
  "collection": "Example NFT",
  "totalSupply": 10000,
  "chain": "ethereum"
}
GET/nft/{contract}/{tokenId}Get NFT collection data and token metadata.$0.002

Get NFT collection data and token metadata.

Parameters
chainquery / EVM chain only · default: base
contractpath / contract (hex for EVM, base58 for Solana) · required
tokenIdpath / string · required
Request
curl "https://chainray.online/nft/{contract}/{tokenId}?chain=ethereum"
Example response
{
  "collection": "Example NFT",
  "totalSupply": 10000,
  "chain": "ethereum"
}
GET/nft-floor/{address}Get floor price data for an NFT collection.$0.007

Get floor price data for an NFT collection.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/nft-floor?address=0x...&chain=ethereum"
Example response
{
  "collection": "0x...",
  "floorPrice": null,
  "chain": "ethereum"
}
GET/nft-holders/{contract}Get NFT holder distribution data.$0.012

Get NFT holder distribution data.

Parameters
chainquery / EVM chain only · default: base
contractpath / contract (hex for EVM, base58 for Solana) · required
limitquery / integer · default: 20
Request
curl "https://chainray.online/nft-holders/0x<contract>?chain=ethereum"
Example response
{
  "collection": "0x...",
  "holders": [],
  "uniqueHolders": 0,
  "chain": "ethereum"
}

Oracle4 route entries

GET/oracle/price-feed/{token}Price oracle feed with multi-source aggregation.$0.002

Price oracle feed with multi-source aggregation.

Parameters
chainquery / Target blockchain. Native-asset only on: monad, tempo, megaeth, arc, plasma, katana, robinhood, pharos, hyperevm. · default: base
tokenpath / string · required
Request
curl "https://chainray.online/oracle/price-feed/ETH"
Example response
{
  "token": "ETH",
  "priceUsd": 3245.67,
  "sources": [
    "on-chain",
    "DeFi Llama"
  ],
  "confidence": "high"
}
GET/oracle/gas-avgGet average gas price oracle data.$0.007

Get average gas price oracle data.

Parameters
chainsquery / string · default: base,ethereum,arbitrum,optimism,polygon
Request
curl "https://chainray.online/oracle/gas-avg?chains=base,ethereum"
Example response
{
  "chain": "base",
  "avgGas": 0.005,
  "unit": "gwei",
  "period": "1h"
}
GET/oracle/chain-statusChain health and status oracle.$0.007

Chain health and status oracle.

ParametersNo parameters. The endpoint is ready to call as published.
Request
curl "https://chainray.online/oracle/chain-status?chain=base"
Example response
{
  "chain": "base",
  "status": "healthy",
  "blockTime": 2,
  "latestBlock": 12345678
}
GET/gas-oracleMulti-speed gas oracle (slow/standard/fast/instant).$0.012

Multi-speed gas oracle (slow/standard/fast/instant).

ParametersNo parameters. The endpoint is ready to call as published.
Request
curl "https://chainray.online/gas-oracle?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "slow": 8,
  "standard": 12,
  "fast": 18,
  "instant": 25,
  "unit": "gwei"
}

Agent9 route entries

GET/agent-card/{agentId}Lookup an AI agent's capability card (A2A protocol).$0.002

Lookup an AI agent's capability card (A2A protocol).

Parameters
agentIdpath / string · required
Request
curl "https://chainray.online/agent-card/example-agent"
Example response
{
  "agentId": "example-agent",
  "capabilities": [],
  "registered": true
}
GET/agent-card/discoverDiscover registered AI agents and their capabilities.$0.007

Discover registered AI agents and their capabilities.

Parameters
capabilityquery / Capability filter (cap is accepted as an alias)
chainquery / string
keywordquery / Keyword filter (q is accepted as an alias)
limitquery / integer · default: 20
Request
curl "https://chainray.online/agent-card/discover"
Example response
{
  "agents": [],
  "totalRegistered": 0
}
GET/agent-reputation/{address}On-chain reputation score for AI agents (ERC-8004).$0.025

On-chain reputation score for AI agents (ERC-8004).

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
formatquery / string · default: json
Request
curl "https://chainray.online/agent-reputation/0x<address>?chain=base"
Example response
{
  "address": "0x...",
  "reputation": 0,
  "factors": {},
  "chain": "base"
}
POST/agent-card/registerRegister an AI agent capability card (A2A protocol).$0.05

Register an AI agent capability card (A2A protocol).

Parameters
body{"type":"object","properties":{"agentId":{"type":"string"},"name":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}}},"required":["agentId","name"]} · required
Request
curl -X POST "https://chainray.online/agent-card/register" -H "Content-Type: application/json" -d '{"name":"MyAgent","capabilities":["trade"]}'
Example response
{
  "registered": true,
  "agentId": "..."
}
GET/context-briefAI-ready context brief — aggregates gas, price, whale, trending, and DeFi data into a single response for agent decision-making.$0.05

AI-ready context brief — aggregates gas, price, whale, trending, and DeFi data into a single response for agent decision-making.

Parameters
chainquery / Target blockchain · default: base
intentquery / string · default: swap
Request
curl "https://chainray.online/context-brief?chain=base"
Example response
{
  "chain": "base",
  "summary": {},
  "gas": {},
  "price": {},
  "whales": {},
  "trending": []
}
POST/context-brief/workflowRole-differentiated context brief with multi-agent workflow orchestration (CaaS v2). Accepts up to three EVM chains; unsupported non-EVM chains are rejected before payment.$0.05

Role-differentiated context brief with multi-agent workflow orchestration (CaaS v2). Accepts up to three EVM chains; unsupported non-EVM chains are rejected before payment.

Parameters
body{"type":"object","properties":{"agents":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5,"description":"Agent roles participating in the workflow"},"intent":{"type":"string","maxLength":256},"chains":{"type":"array","items":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon","bsc","avalanche","zksync","linea","scroll","blast","mantle","gnosis","polygon-zkevm","mode","sei","celo","manta","taiko","fantom","cronos","opbnb","zora","worldchain","metis","fraxtal","kava","zetachain","filecoin","core-dao","aurora","moonbeam","klaytn","bob","canto","monad","tempo","megaeth","arc","plasma","katana","robinhood","pharos","hyperevm"]},"minItems":1,"maxItems":3,"description":"EVM chains only"},"constraints":{"type":"object","maxProperties":12,"additionalProperties":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}},"required":["agents"]} · required
Request
curl -X POST "https://chainray.online/context-brief/workflow" -H "Content-Type: application/json" -d '{"agents":["swap-agent","risk-agent"],"chains":["base"]}'
Example response
{
  "oracleType": "workflow-brief",
  "intent": "execute-trade",
  "agentCount": 2,
  "chainCount": 1,
  "globalContext": {},
  "agentBriefs": {},
  "coordinationSignals": {}
}
GET/intentNatural language intent router — auto-routes your query to the best endpoint combination.$0.035

Natural language intent router — auto-routes your query to the best endpoint combination.

Parameters
chainquery / Target blockchain · default: base
qquery / Natural language query · required
Request
curl "https://chainray.online/intent?q=what%20is%20the%20gas%20price%20on%20ethereum"
Example response
{
  "intent": "gas-check",
  "endpoints": [
    "/gas-tracker"
  ],
  "result": {},
  "chain": "ethereum"
}
GET/watch/{address}Create a watchlist entry with a full data snapshot for an endpoint.$0.025

Create a watchlist entry with a full data snapshot for an endpoint.

Parameters
chainquery / Target blockchain · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/watch/0x<address>?chain=ethereum"
Example response
{
  "watchId": "...",
  "snapshot": {},
  "timestamp": 1713000000000
}
GET/watch-diff/{watchId}Get diff since last watch snapshot. Send the watchToken returned by /watch in the X-Watch-Token header.$0.005

Get diff since last watch snapshot. Send the watchToken returned by /watch in the X-Watch-Token header.

Parameters
watchIdpath / string · required
X-Watch-Tokenheader / Capability token returned by /watch. · required
Request
curl -H "X-Watch-Token: <watchToken>" "https://chainray.online/watch-diff/<watchId>?chain=ethereum"
Example response
{
  "watchId": "...",
  "changed": true,
  "diff": {},
  "timestamp": 1713000000000
}

Predictions4 route entries

GET/predict/gasGas price prediction for next 5 minutes and 1 hour based on block trend analysis.$0.012

Gas price prediction for next 5 minutes and 1 hour based on block trend analysis.

Parameters
chainquery / Target blockchain · default: base
Request
curl "https://chainray.online/predict/gas?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "predictions": {
    "next5min": 14.2,
    "next1hr": 12.8
  },
  "methodology": "statistical"
}
GET/predict/whale-moveWhale behavior prediction based on historical patterns.$0.035

Whale behavior prediction based on historical patterns.

Parameters
chainquery / Target blockchain · default: base
Request
curl "https://chainray.online/predict/whale-move?chain=ethereum"
Example response
{
  "chain": "ethereum",
  "prediction": {},
  "confidence": "medium"
}
GET/predict/liquidityTVL and liquidity trend prediction.$0.035

TVL and liquidity trend prediction.

Parameters
chainquery / Target blockchain · default: base
Request
curl "https://chainray.online/predict/liquidity?chain=base"
Example response
{
  "chain": "base",
  "prediction": {},
  "trend": "stable"
}
GET/predict/token-momentumToken momentum prediction based on volume and price patterns.$0.035

Token momentum prediction based on volume and price patterns.

Parameters
chainquery / Target blockchain · default: base
tokenquery / string · default: native
Request
curl "https://chainray.online/predict/token-momentum?chain=base"
Example response
{
  "chain": "base",
  "tokens": [],
  "prediction": {}
}

Analytics1 route entries

GET/mev-intelCross-DEX spread analysis with gas cost estimation. Uses heuristic model based on 24h price volatility — NOT real-time mempool data.$0.05

Cross-DEX spread analysis with gas cost estimation. Uses heuristic model based on 24h price volatility — NOT real-time mempool data.

Parameters
chainquery / Target blockchain · default: base
Request
curl "https://chainray.online/mev-intel?chain=base"
Example response
{
  "type": "mev-intelligence",
  "chain": "base",
  "opportunities": [],
  "viableCount": 0,
  "methodology": "Heuristic estimation",
  "limitations": [
    "Not real-time",
    "No mempool access"
  ]
}

Aggregated5 route entries

GET/chain-overviewFull chain overview in one call: gas + health + protocol + supply + block. A discounted bundle of five related reads.$0.015

Full chain overview in one call: gas + health + protocol + supply + block. A discounted bundle of five related reads.

Parameters
chainquery / Target blockchain · default: base
Request
curl "https://chainray.online/chain-overview?chain=base"
Example response
{
  "chain": "base",
  "gas": {},
  "health": {},
  "protocols": [],
  "supply": {},
  "block": {}
}
GET/defi-scanAggregated DeFi scan: yields + TVL + farming + stablecoins + comparison.$0.03

Aggregated DeFi scan: yields + TVL + farming + stablecoins + comparison.

Parameters
chainquery / Target blockchain · default: base
Request
curl "https://chainray.online/defi-scan?chain=base"
Example response
{
  "chain": "base",
  "yields": {},
  "tvl": {},
  "farms": {},
  "stablecoins": {}
}
GET/security-check/{address}Aggregated security check: token risk + contract scan + approvals + credit score.$0.04

Aggregated security check: token risk + contract scan + approvals + credit score.

Parameters
chainquery / Target blockchain · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/security-check?address=0x...&chain=base"
Example response
{
  "address": "0x...",
  "tokenRisk": {},
  "contractScan": {},
  "approvals": {},
  "creditScore": {}
}
GET/wallet-intel/{address}Aggregated wallet intelligence: profile + interactions + credit + portfolio + labels.$0.04

Aggregated wallet intelligence: profile + interactions + credit + portfolio + labels.

Parameters
chainquery / Target blockchain · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
Request
curl "https://chainray.online/wallet-intel?address=0x...&chain=base"
Example response
{
  "address": "0x...",
  "profile": {},
  "interactions": {},
  "credit": {},
  "portfolio": {},
  "labels": {}
}
GET/trade-signalAggregated trade signal: trending + whales + smart money + pairs + KOL.$0.04

Aggregated trade signal: trending + whales + smart money + pairs + KOL.

Parameters
chainquery / Target blockchain · default: base
Request
curl "https://chainray.online/trade-signal?chain=base"
Example response
{
  "chain": "base",
  "trending": {},
  "whales": {},
  "smartMoney": {},
  "newPairs": {},
  "kol": {}
}

Real-time Stream5 route entries

GET/stream/whale-alerts60-second Server-Sent Events stream of whale movements. Events pushed every 5 seconds.$0.05

60-second Server-Sent Events stream of whale movements. Events pushed every 5 seconds.

Parameters
chainquery / Target blockchain · default: base
durationquery / integer · default: 60
Request
curl -N "https://chainray.online/stream/whale-alerts?chain=ethereum"
Example response
SSE stream: data: {type: 'whale-monitor', alerts: [...], timestamp: ...}
GET/stream/gas60-second real-time gas price stream. Updates every 3 seconds.$0.02

60-second real-time gas price stream. Updates every 3 seconds.

Parameters
chainquery / Target blockchain · default: base
durationquery / integer · default: 60
Request
curl -N "https://chainray.online/stream/gas?chain=ethereum"
Example response
SSE stream: data: {type: 'gas-monitor', gas: {...}, timestamp: ...}
GET/stream/price/{token}60-second real-time token price stream.$0.02

60-second real-time token price stream.

Parameters
chainquery / Target blockchain. Native-asset only on: monad, tempo, megaeth, arc, plasma, katana, robinhood, pharos, hyperevm. · default: base
tokenpath / string · required
durationquery / integer · default: 60
Request
curl -N "https://chainray.online/stream/price/ETH?chain=base"
Example response
SSE stream: data: {type: 'price-monitor', price: {...}, timestamp: ...}
GET/stream/trades/{pool}60-second real-time DEX trade stream.$0.035

60-second real-time DEX trade stream.

Parameters
chainquery / Target blockchain · default: base
poolpath / pool (hex for EVM, base58 for Solana) · required
durationquery / integer · default: 60
Request
curl -N "https://chainray.online/stream/trades?chain=base"
Example response
SSE stream: data: {type: 'trade-monitor', trades: [...], timestamp: ...}
GET/stream/mempool60-second large pending transaction stream. Monitors whale-scale transfers in near real-time.$0.08

60-second large pending transaction stream. Monitors whale-scale transfers in near real-time.

Parameters
chainquery / Target blockchain · default: base
durationquery / integer · default: 60
Request
curl -N "https://chainray.online/stream/mempool?chain=ethereum"
Example response
SSE stream: data: {type: 'mempool-monitor', status: 'complete'|'partial', unavailableComponents: [...], largeTransfers: [...]|null, gasConditions: {...}|null, timestamp: ...}

Utility3 route entries

GET/tx-decode/{txHash}Decode transaction input data into human-readable format.$0.012

Decode transaction input data into human-readable format.

Parameters
chainquery / EVM chain only · default: base
txHashpath / string · required
Request
curl "https://chainray.online/tx-decode/0x<txHash>?chain=base"
Example response
{
  "txHash": "0x...",
  "decoded": {
    "method": "swap",
    "params": {}
  },
  "chain": "base"
}
POST/batchPlan B batch: $0.01 per request for up to 10 high-frequency queries. Each endpoint must cost $0.007 or less; combined individual-call value is capped at $0.025.$0.01

Plan B batch: $0.01 per request for up to 10 high-frequency queries. Each endpoint must cost $0.007 or less; combined individual-call value is capped at $0.025.

Parameters
body{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object"},"minItems":1,"maxItems":10,"description":"Plan B: endpoints priced at $0.007 or less; combined individual-call value max $0.025. One fixed $0.01 payment covers the batch."}},"required":["queries"],"additionalProperties":false} · required
Request
curl -X POST "https://chainray.online/batch" -H "Content-Type: application/json" -d '{"queries":[{"endpoint":"/price","params":{"token":"ETH"}},{"endpoint":"/gas-tracker"}]}'
Example response
{
  "batchSize": 2,
  "results": [
    "..."
  ],
  "individualCallValue": "$0.004",
  "x402Charge": "$0.01",
  "savings": "$0"
}
GET/verify-proofVerify a Chain Proof cryptographic signature to confirm data authenticity.$0.005

Verify a Chain Proof cryptographic signature to confirm data authenticity.

Parameters
chainquery / Target blockchain · default: base
hashquery / dataHash from _proof field · required
Request
curl "https://chainray.online/verify-proof?hash=<dataHash>"
Example response
{
  "valid": true,
  "chain": "base",
  "blockNumber": 12345678
}

Identity1 route entries

GET/ens-resolve/{nameOrAddress}Resolve ENS name to address or reverse lookup.$0.002

Resolve ENS name to address or reverse lookup.

Parameters
nameOrAddresspath / string · required
Request
curl "https://chainray.online/ens-resolve?name=vitalik.eth"
Example response
{
  "name": "vitalik.eth",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "avatar": null
}

Block Data2 route entries

GET/block-infoGet information about a specific block or the latest block.$0.002

Get information about a specific block or the latest block.

Parameters
chainquery / EVM chain only · default: base
blockquery / Block number (omit for latest)
Request
curl "https://chainray.online/block-info?chain=base"
Example response
{
  "chain": "base",
  "blockNumber": 12345678,
  "timestamp": 1713000000,
  "txCount": 45,
  "gasUsed": "12000000"
}
GET/chain-healthChain health metrics — block time, finality, RPC status.$0.025

Chain health metrics — block time, finality, RPC status.

Parameters
chainquery / EVM chain only · default: base
Request
curl "https://chainray.online/chain-health?chain=base"
Example response
{
  "chain": "base",
  "healthy": true,
  "blockTime": 2,
  "latestBlock": 12345678
}

Contract Data1 route entries

GET/contract-events/{address}Get recent contract events/logs for an address.$0.007

Get recent contract events/logs for an address.

Parameters
chainquery / EVM chain only · default: base
addresspath / address (hex for EVM, base58 for Solana) · required
blocksquery / integer · default: 500
Request
curl "https://chainray.online/contract-events/0x...?chain=base"
Example response
{
  "address": "0x...",
  "events": [],
  "chain": "base"
}
Integration note

Designed for an agent loop.

Start with a small paid read, keep the response proof attached to your state, and move to batch, watch, stream, or MCP when the workflow needs more context.

Read the agent index