ChainRay logoChainRay
Menu
API docsOpenAPIllms.txtstatusAbout
Connect MCP
02 / MACHINE CONTRACT

The contract agents can inspect.

OpenAPI gives tooling a precise map of the paid surface. Browse the routes here, or use the raw JSON when an agent needs the schema directly.

Raw openapi.json Read API docs
SpecificationOpenAPI 3.1x-payment-info on every paid operation
Published routes94 templates93 logical capabilities
Payment networkeip155:8453USDC on Base / exact scheme
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/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/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/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/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/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"
}
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/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
}
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/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/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/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/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/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/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/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/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/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/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/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/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"
}
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/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/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/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/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/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/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/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"
}
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"
}
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/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/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/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/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/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/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/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/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/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/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/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/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/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/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
}
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/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"
}
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/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
}
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/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"
}
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"
}
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"
  ]
}
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": []
}
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"
}
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/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"
}
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/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/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": {}
}
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"
}
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/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": {}
}
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/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
}
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
}
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": {}
}
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"
  ]
}
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: ...}
Schema handoff

Keep the machine contract close.

Use the raw schema for code generation, validate payment metadata before calling a route, and keep the response proof attached to the result your agent stores.