Skip to main content
The Chain Scout Agent provides comprehensive on-chain analytics using Alchemy, Etherscan, and DeFiLlama APIs.

​
Pricing

Each request costs $0.01 USD (paid via x402 on Base Sepolia testnet).

​
Analyze Wallet

Get comprehensive wallet analytics including portfolio value, token holdings, NFTs, and transaction history.
GET /api/x402/scout/analyze
curl https://api.arcana.markets/api/x402/scout/analyze?address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb \
  -H "Authorization: Bearer YOUR_X402_TOKEN"

​
Query Parameters

​
address
string
required
Ethereum wallet address or ENS name

​
Response

​
success
boolean
Whether the request succeeded
​
data
object
​
address
string
Normalized wallet address
​
ensName
string
ENS name (if available)
​
walletAgeDays
number
Days since first transaction
​
isContract
boolean
Whether address is a smart contract
​
ethBalance
number
ETH balance
​
ethBalanceUsd
number
Total portfolio value in USD
​
portfolio
object
Token holdings across all supported chains
​
history
array
Recent transactions (last 50)
​
nftsWithFloorPrice
array
NFT holdings with floor prices
​
labels
string[]
Wallet labels (e.g., “Whale”, “High Activity”)
​
payment
object
x402 payment receipt

​
Get Gas Prices

Retrieve current Ethereum gas prices for different transaction speeds.
GET /api/x402/scout/gas
curl https://api.arcana.markets/api/x402/scout/gas \
  -H "Authorization: Bearer YOUR_X402_TOKEN"

​
Response

​
data
object
​
low
number
Low priority gas price (Gwei) - 5-10 min confirmation
​
average
number
Average gas price (Gwei) - 1-3 min confirmation
​
fast
number
Fast gas price (Gwei) - ~15 sec confirmation
​
baseFee
number
Current EIP-1559 base fee (Gwei)
{
  "success": true,
  "data": {
    "low": 8,
    "average": 12,
    "fast": 18,
    "baseFee": 7.2
  },
  "payment": { /* x402 receipt */ }
}

​
Estimate Transaction Cost

Estimate gas cost for common transaction types.
GET /api/x402/scout/gas-estimate
curl https://api.arcana.markets/api/x402/scout/gas-estimate?operation=swap_dex \
  -H "Authorization: Bearer YOUR_X402_TOKEN"

​
Query Parameters

​
operation
string
default:"eth_transfer"
Transaction type:
  • eth_transfer - Simple ETH transfer (21,000 gas)
  • erc20_transfer - ERC20 token transfer (65,000 gas)
  • nft_transfer - NFT transfer (85,000 gas)
  • swap_dex - DEX swap (180,000 gas)
  • bridge - Cross-chain bridge (150,000 gas)

​
Response

​
data
object
​
operation
string
Operation type
​
gasLimit
number
Estimated gas limit
​
gasPriceGwei
number
Gas price used (fast tier)
​
ethCost
number
Cost in ETH
​
usdCost
number
Cost in USD
​
formattedCost
string
Human-readable cost string

​
Get DEX Volume Report

Retrieve DEX volume data for a specific blockchain.
GET /api/x402/scout/dex
curl https://api.arcana.markets/api/x402/scout/dex?chain=ethereum \
  -H "Authorization: Bearer YOUR_X402_TOKEN"

​
Query Parameters

​
chain
string
default:"ethereum"
Blockchain name (e.g., ethereum, arbitrum, base, optimism, polygon)

​
Response

​
data
object
​
chain
string
Chain name
​
totalVolume24h
number
Total 24h DEX volume (USD)
​
topDexes
array
Top 5 DEXs by volume with 24h change

​
Get Protocol Stats

Retrieve TVL and fees for a specific DeFi protocol.
GET /api/x402/scout/protocol
curl https://api.arcana.markets/api/x402/scout/protocol?protocol=uniswap \
  -H "Authorization: Bearer YOUR_X402_TOKEN"

​
Query Parameters

​
protocol
string
required
Protocol name (e.g., uniswap, aave, curve, lido, makerdao)

​
Response

Returns TVL, fees, revenue, and chain breakdown for the protocol.

​
Get Bridge Activity

Retrieve top cross-chain bridge volume and activity.
GET /api/x402/scout/bridges
curl https://api.arcana.markets/api/x402/scout/bridges \
  -H "Authorization: Bearer YOUR_X402_TOKEN"

​
Response

Returns top bridges by 24h volume with chain breakdown.

​
Get Recent Hacks

Retrieve recent DeFi exploits and hacks from DeFiLlama.
GET /api/x402/scout/hacks
curl https://api.arcana.markets/api/x402/scout/hacks \
  -H "Authorization: Bearer YOUR_X402_TOKEN"

​
Response

Returns list of recent security incidents with amounts lost and affected protocols.

​
x402 Payment Flow

All Chain Scout endpoints require payment via x402:
  • Price: $0.01 per request
  • Network: Base Sepolia (eip155:84532)
  • Seller Address: 0xf09bC01bEb00b142071b648c4826Ab48572aEea5
Wallet analysis queries data from Alchemy across Ethereum, Base, Arbitrum, Optimism, and Polygon.

Build docs developers (and LLMs) love

Get started for freeTalk to us