deepblue-defi-api

# 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](https://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:** `https://deepbluebase.xyz`

All endpoints are read-only GET requests. No authentication, wallet signing, or tokens required.

### ETH/USD Price

```bash
curl https://deepbluebase.xyz/price/eth
```
```json
{"eth_usd": 1966.77, "source": "chainlink+coingecko", "cached_ttl": 60}
```

### Trending Pools on Base

```bash
curl https://deepbluebase.xyz/trending
```
```json
{"pools": [{"name": "TOKEN / WETH", "symbol": "TOKEN", "token_address": "0x...", "price_usd": "0.001", "price_change_24h": 42.5, "volume_24h": 150000, "score": 0.68}], "tier": "free", "showing": "5/10"}
```

### Token Buy Score (0.0–1.0)

```bash
curl https://deepbluebase.xyz/token/0xTOKEN_ADDRESS/score
```
```json
{"token": "0x...", "symbol": "FELIX", "score": 0.41, "price_usd": "0.00012", "pool_data": {"raw_price_change_24h": 56.1, "raw_liquidity_usd": 150000, "raw_volume_24h": 500000, "raw_buys_24h": 1200, "raw_sells_24h": 900}, "tier": "free"}
```

Score breakdown:
- **0.7+** Strong buy signal (high...