vaaya / docs / reference

On-chain & markets

Crypto, market, and prediction-market data behind three gateway services: blockrun/fetch (market reads + prediction markets), heurist/agent (wallet and token forensics, crypto-Twitter signal), and kadec0/fetch (cheap DeFi reads). Endpoints are params — find exact slugs with the free vaaya/discover (see Discovery).

Picking a lane

blockrun/fetch — market data + prediction markets

Price

1–2¢ typical (/api/v1/surf/onchain/schema is the priciest at 4¢)

Endpoints

103

Method

GET-style — endpoint is a param

Two endpoint families. /api/v1/surf/* covers crypto market reads: market/price, market/ranking, market/fear-greed, market/onchain-indicator, exchange/price, exchange/perp, news/feed, search/news, social/mindshare, onchain/gas-price, onchain/schema. /api/v1/pm/* covers prediction markets: polymarket/markets|events|trades|positions|leaderboard, kalshi/markets, sports/markets, limitless/markets, predictfun/markets, opinion/markets, binance/candles/<SYMBOL>, and cross-venue markets/search.

curl -X POST https://vaaya.ai/api/run/blockrun/fetch \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpoint": "/api/v1/pm/kalshi/markets", "q": "fed rates"}'

curl -X POST https://vaaya.ai/api/run/blockrun/fetch \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpoint": "/api/v1/surf/market/price", "symbol": "ETH"}'

heurist/agent — crypto-intel agent tools

Price

2–5¢

Endpoints

30

Method

POST — args go flat in the body

Endpoint shape is /x402/agents/<Agent>/<tool>. Highlights: TwitterIntelligenceAgent/twitter_search|user_timeline, ElfaTwitterIntelligenceAgent/search_mentions (crypto-Twitter signal), EtherscanAgent/get_address_history|get_erc20_top_holders, ZerionWalletAnalysisAgent/fetch_wallet_tokens|fetch_wallet_nfts, PondWalletAnalysisAgent/analyze_ethereum_wallet|analyze_base_wallet, GoplusAnalysisAgent/fetch_security_details (token safety), FundingRateAgent/* (rates + spot-futures arb), PumpFunTokenAgent/*, TrendingTokenAgent/get_trending_tokens, UnifaiWeb3NewsAgent/get_web3_news.

curl -X POST https://vaaya.ai/api/run/heurist/agent \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpoint": "/x402/agents/GoplusAnalysisAgent/fetch_security_details", "token_address": "0x..."}'

kadec0/fetch — cheap DeFi reads

Price

1–21¢

Endpoints

29

DeFi rows: /v1/defi-tvl, /v1/yield-pools, /v1/token-price, /v1/gas-oracle, /v1/trending-coins, /v1/stablecoins, /v1/market-sentiment. Its public-data rows — papers, CVEs, congress trades — are covered under Research.

Gotchas

• Listed prices are caps — you’re debited the actual cost per call, never more than the cap, and failed calls charge nothing.
• Endpoint slugs change and grow — vaaya/discover { "query": "polymarket trades" } (free) always returns the current slug and price. See Discovery.
• These services are for market data and research. For token-security and wallet due-diligence with a compliance framing, see the Web3 checks on Compliance & KYB.