DeepBlue DeFi Research API
Overview
Public, read-only REST API built by DeepBlue — a team of 4 autonomous AI agents on Base. Provides live on-chain DeFi research data: ETH prices from Chainlink, trending pools from GeckoTerminal, token buy-score analysis, and wallet ERC20 scans via Blockscout.
Free to use: 10 requests/day, no authentication required.
Source code and full project at github.com/ERROR403agent/clawford.
When to Use
- - You need current ETH/USD price from an on-chain source (Chainlink)
- You want to discover trending tokens/pools on Base
- You need to score a token's buy quality (momentum, volume, buy pressure, liquidity)
- You need to scan a wallet's ERC20 holdings with USD valuations
Do not use when:
- - You need data for chains other than Base (only Base supported currently)
- You need historical data (this is live/current data only)
- You need trading execution (this is read-only research data)
API Reference
Base URL: INLINECODE0
All endpoints are read-only GET requests. No authentication, wallet signing, or tokens required.
ETH/USD Price
CODEBLOCK0
CODEBLOCK1
Trending Pools on Base
CODEBLOCK2
CODEBLOCK3
Token Buy Score (0.0–1.0)
CODEBLOCK4
CODEBLOCK5
Score breakdown:
- - 0.7+ Strong buy signal (high momentum, healthy volume/liquidity, bullish pressure)
- 0.5–0.7 Moderate — some positive indicators
- Below 0.5 Weak — caution advised
Wallet ERC20 Scan
CODEBLOCK6
CODEBLOCK7
DEEP Token Info
CODEBLOCK8
Health Check
CODEBLOCK9
Python Integration
CODEBLOCK10
Response Format
All endpoints return JSON. Errors return {"detail": "error message"} with appropriate HTTP status codes (400, 404, 429).
Rate Limits
10 requests per day per IP. The /trending and /health endpoints are unlimited.
Need more? Hold any amount of $DEEP on Base for 100 requests/day plus AI-powered token diagnosis and live trade signals. Details: INLINECODE5
Privacy & Data Handling
- - Stateless API — No wallet addresses, queries, or IP addresses are stored or logged. All requests are processed and discarded.
- Public data only — Every response is derived from publicly available on-chain data (Base blockchain via Blockscout, Chainlink price feeds, GeckoTerminal pool data). No private or off-chain data is accessed or returned.
- No authentication or wallet signing — The API never requests private keys, signatures, seed phrases, or wallet connections. All endpoints are anonymous GET requests.
- $DEEP holder tier — Higher rate limits for $DEEP holders are enforced via a read-only on-chain balance check of the requesting IP's associated address (if provided via the
/token/.../score path). No wallet identification, auth tokens, or session tracking is involved.
Operator & Provenance
- - Operated by: DeepBlue — a team of 4 autonomous AI agents (EXEC, Mr. Clawford, Dr. ZoidClaw, Fishy) built and maintained by FlippersPad.
- Source code: Fully open-source at github.com/ERROR403agent/clawford. The API server (
deep_api.py), scoring engine (defi_engine.py), and this skill definition are all in the repo. - Infrastructure: Hosted on AWS EC2 (us-east). The API is a lightweight FastAPI server proxying public blockchain data sources — it does not hold funds, execute trades, or access any wallets.
- Contact: Discord or via GitHub issues.
Links
DeepBlue DeFi 研究 API
概述
由 DeepBlue 构建的公共只读 REST API——这是一个由 4 个自主 AI 代理组成的团队，运行于 Base 链上。提供实时链上 DeFi 研究数据：来自 Chainlink 的 ETH 价格、来自 GeckoTerminal 的热门池、代币买入评分分析，以及通过 Blockscout 进行的钱包 ERC20 扫描。
免费使用： 每天 10 次请求，无需身份验证。
源代码和完整项目请访问 github.com/ERROR403agent/clawford。
使用场景
- - 需要从链上来源（Chainlink）获取当前 ETH/USD 价格
- 想要发现 Base 链上的热门代币/池
- 需要对代币的买入质量进行评分（动量、交易量、买入压力、流动性）
- 需要扫描钱包的 ERC20 持仓并附带美元估值
不适用场景：
- - 需要 Base 以外其他链的数据（目前仅支持 Base）
- 需要历史数据（仅提供实时/当前数据）
- 需要交易执行（此为只读研究数据）
API 参考
基础 URL： https://deepbluebase.xyz
所有端点均为只读 GET 请求。无需身份验证、钱包签名或代币。
ETH/USD 价格
bash
curl https://deepbluebase.xyz/price/eth
json
{ethusd: 1966.77, source: chainlink+coingecko, cachedttl: 60}
Base 链热门池
bash
curl https://deepbluebase.xyz/trending
json
{pools: [{name: TOKEN / WETH, symbol: TOKEN, tokenaddress: 0x..., priceusd: 0.001, pricechange24h: 42.5, volume_24h: 150000, score: 0.68}], tier: free, showing: 5/10}
代币买入评分（0.0–1.0）
bash
curl https://deepbluebase.xyz/token/0xTOKEN_ADDRESS/score
json
{token: 0x..., symbol: FELIX, score: 0.41, priceusd: 0.00012, pooldata: {rawpricechange24h: 56.1, rawliquidityusd: 150000, rawvolume24h: 500000, rawbuys24h: 1200, rawsells_24h: 900}, tier: free}
评分说明：
- - 0.7 以上 强烈买入信号（高动量、健康的交易量/流动性、看涨压力）
- 0.5–0.7 中等——部分积极指标
- 低于 0.5 弱势——建议谨慎
钱包 ERC20 扫描
bash
curl https://deepbluebase.xyz/wallet/0xWALLET_ADDRESS/scan
json
{wallet: 0x..., tokens: [{symbol: USDC, balance: 500.0, value_usd: 500.0}], tier: free, showing: 3/15}
DEEP 代币信息
bash
curl https://deepbluebase.xyz/deep/info
健康检查
bash
curl https://deepbluebase.xyz/health
Python 集成
python
import requests
BASE = https://deepbluebase.xyz
获取 ETH 价格
price = requests.get(f{BASE}/price/eth).json()[eth_usd]
获取带评分的热门池
trending = requests.get(f{BASE}/trending).json()
for pool in trending[pools]:
print(f{pool[symbol]}: ${pool[price
usd]} ({pool[pricechange_24h]:+.1f}%))
对特定代币进行评分
token = 0xf30bf00edd0c22db54c9274b90d2a4c21fc09b07
result = requests.get(f{BASE}/token/{token}/score).json()
print(f{result[symbol]} 买入评分: {result[score]})
扫描钱包
wallet = 0xf9547FE0A27CBADDFcEF282C0b37F410cbaD11BE
holdings = requests.get(f{BASE}/wallet/{wallet}/scan).json()
for t in holdings[tokens]:
print(f{t[symbol]}: ${t[value_usd]:.2f})
响应格式
所有端点返回 JSON。错误返回 {detail: error message} 并附带相应的 HTTP 状态码（400、404、429）。
速率限制
每个 IP 每天 10 次请求。/trending 和 /health 端点无限制。
需要更多？在 Base 链上持有任意数量的 $DEEP 可获得 每天 100 次请求，外加 AI 驱动的代币诊断和实时交易信号。详情：GET /pricing
隐私与数据处理
- - 无状态 API — 不存储或记录任何钱包地址、查询或 IP 地址。所有请求处理完毕后即被丢弃。
- 仅公开数据 — 每个响应均来自公开可用的链上数据（通过 Blockscout 获取的 Base 区块链数据、Chainlink 价格馈送、GeckoTerminal 池数据）。不访问或返回任何私有或链下数据。
- 无需身份验证或钱包签名 — API 从不请求私钥、签名、助记词或钱包连接。所有端点均为匿名 GET 请求。
- $DEEP 持有者层级 — 通过只读链上余额检查（如果通过 /token/.../score 路径提供了关联地址）来强制执行 $DEEP 持有者的更高速率限制。不涉及钱包识别、身份验证令牌或会话跟踪。
运营方与来源
- - 运营方： DeepBlue——由 FlippersPad 构建和维护的 4 个自主 AI 代理团队（EXEC、Mr. Clawford、Dr. ZoidClaw、Fishy）。
- 源代码： 完全开源，位于 github.com/ERROR403agent/clawford。API 服务器（deepapi.py）、评分引擎（defiengine.py）以及本技能定义均在该仓库中。
- 基础设施： 托管于 AWS EC2（美国东部）。API 是一个轻量级 FastAPI 服务器，代理公共区块链数据源——不持有资金、不执行交易、不访问任何钱包。
- 联系方式： Discord 或通过 GitHub Issues。
链接
