메뉴
Live token prices, gas and FX oracles, swap quotes, wallet analytics, DeFi position tracking, and ENS/Basename resolution for AI agents on Base. Read on-chain market and wallet intelligence pay-per-call via x402 — no API keys, no accounts. Powered by Spraay Protocol.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | DeFi Intelligence |
| description | Live token prices, gas and FX oracles, swap quotes, wallet analytics, DeFi position tracking, and ENS/Basename resolution for AI agents on Base. Read on-chain market and wallet intelligence pay-per-call via x402 — no API keys, no accounts. Powered by Spraay Protocol. |
| license | MIT |
| version | 1.0.0 |
| homepage | https://github.com/plagtech/defi-intelligence-x402 |
Read-only market and wallet intelligence for agents operating on Base. This skill wraps the Spraay x402 Gateway (gateway.spraay.app): price and gas oracles, swap quotes across Base DEXes, wallet profiling, transaction history, DeFi position tracking, and ENS/Basename resolution. Every call is paid per-use with x402 in USDC — no API keys, accounts, or subscriptions.
Use it when the agent needs to understand on-chain state before acting:
For sending value (batch pay, payroll, escrow) use the agent-payments skill in this repo. Note: /api/v1/swap/execute is included here for convenience, but a pure read agent can stop at /swap/quote.
npm install x402-client
export EVM_PRIVATE_KEY=0x... # wallet holding USDC on Base
import { createClient } from "x402-client";
const client = createClient({
baseUrl: "https://gateway.spraay.app",
privateKey: process.env.EVM_PRIVATE_KEY,
});
The gateway answers an unpaid request with HTTP 402 and the price; the client pays and retries automatically.
| Method | Path | Price | Description |
|---|---|---|---|
| GET | /api/v1/oracle/prices | $0.008 | Aggregated oracle price feed across multiple sources. |
| GET | /api/v1/oracle/gas | $0.005 | Real-time gas prices on Base. |
| GET | /api/v1/oracle/fx | $0.008 | Stablecoin FX rates: USDC, USDT, DAI, EURC, pyUSD, more. |
| GET | /api/v1/prices | $0.002 | Cached, low-latency multi-token price feed. |
| Method | Path | Price | Description |
|---|---|---|---|
| GET | /api/v1/analytics/wallet | $0.01 | Wallet profile: balances, top tokens, activity tier, age, risk signals. |
| GET | /api/v1/analytics/txhistory | $0.008 | Transaction history for any address on Base. |
| GET | /api/v1/balances | $0.005 | Token balance lookup for any address on Base. |
| GET | /api/v1/tokens | FREE | Supported tokens on Base. |
| Method | Path | Price | Description |
|---|---|---|---|
| GET | /api/v1/swap/quote | $0.008 | Swap quote across Uniswap V3, Aerodrome, and other Base DEXes. |
| GET | /api/v1/swap/tokens | $0.001 | Supported swap tokens with addresses, decimals, metadata. |
| POST | /api/v1/swap/execute | $0.015 | Execute a swap on Base via the MangoSwap router. |
| Method | Path | Price | Description |
|---|---|---|---|
| GET | /api/v1/defi/positions | $0.01 | Open DeFi positions for an address across supported protocols. |
| GET | /api/v1/resolve | $0.002 | Resolve an ENS, Basename, or address to its canonical identity. |
Live prices and gas:
const prices = await client.get("/api/v1/oracle/prices"); // { ETH: 2847.50, BTC: ... }
const gas = await client.get("/api/v1/oracle/gas");
Profile a wallet before interacting:
const profile = await client.get("/api/v1/analytics/wallet?address=0xabc...");
Quote a swap:
const quote = await client.get(
"/api/v1/swap/quote?tokenIn=USDC&tokenOut=WETH&amount=100"
);
Resolve a Basename:
const id = await client.get("/api/v1/resolve?name=jesse.base.eth");