🐙 DeepBlue API

🚀 Getting Started in 3 Steps

The DeepBlue API is built for autonomous AI agents. No accounts, no rate limits on most endpoints — just pay in USDC and get data instantly.

Step 1 — Get a USDC wallet (Base or Solana)

You need any EVM wallet with USDC on Base (chain ID 8453), or a Solana wallet with USDC. Fund it with a few cents to get started — most calls cost $0.001–$0.01.

Step 2 — Install the x402 SDK

# JavaScript / Node.js
npm install x402-axios

# Python
pip install x402

The SDK intercepts HTTP 402 responses and signs payments automatically from your wallet private key.

Step 3 — Make your first call

import axios from 'axios';
import { wrapAxios } from 'x402-axios';

const client = wrapAxios(axios, { privateKey: process.env.PRIVATE_KEY });

// Get live BTC signal — costs $0.01 USDC, paid automatically
const { data } = await client.get('https://api.deepbluebase.xyz/signals');
console.log(data.signals[0]);
// → { coin: 'BTC', direction: 'UP', confidence: 0.68, regime: 'momentum' }

📡 How x402 Payments Work

We use the x402 protocol via PayAI facilitator. Your agent pays automatically — no manual steps, no accounts.

1. Request: Your agent calls any endpoint
2. 402 Response: API returns payment requirements (amount, wallet, network)
3. Auto-pay: x402 SDK signs and broadcasts USDC — Base or Solana
4. Data: Request retries with payment proof and returns instantly

Listed on x402scan.com — discoverable by AI agents browsing the x402 ecosystem.

💰 Pricing

All prices in USDC. Micro-transaction tier — designed for high-frequency agent use.

🔌 Endpoints

GET /price/{token}

Real-time price for any token (ETH, BTC, USDC, or contract address).

curl https://api.deepbluebase.xyz/price/ETH

{
  "token": "ETH",
  "price_usd": 2041.30,
  "source": "GeckoTerminal",
  "timestamp": "2026-03-13T05:00:00Z"
}

GET /trending

Top 10 trending pools on Base chain with volume, price change, and momentum score.

curl https://api.deepbluebase.xyz/trending

{
  "pools": [
    {
      "name": "BRETT / WETH",
      "symbol": "BRETT",
      "token_address": "0x532f27101965dd16442e59d40670faf5ebb142e4",
      "price_usd": 0.0842,
      "price_change_24h": 14.3,
      "volume_24h": 4821034.50,
      "score": 0.76
    }
  ],
  "tier": "x402",
  "count": 10
}

GET /signals

Real-time signals from Fishy — our Polymarket 5-min BTC/ETH/SOL/XRP trading bot. These are the exact signals the bot uses to place trades.

{
  "signals": [
    {
      "coin": "BTC",
      "direction": "UP",
      "confidence": 0.68,
      "regime": "momentum",
      "source": "realtime_feed"
    },
    {
      "coin": "ETH",
      "direction": "DOWN",
      "confidence": 0.61,
      "regime": "mean_reversion",
      "source": "realtime_feed"
    }
  ],
  "count": 4,
  "source": "RealtimeSignalGenerator"
}

GET /performance

Our live Polymarket trading track record — every trade, real P&L, win rate. On-chain settlements are verifiable on Polygon.

{
  "portfolio": {
    "wallet_usdc": 29.88,
    "total_pnl_usdc": -12.40,
    "win_rate": 48.2,
    "total_trades": 312,
    "wins": 150
  },
  "recent_trades": [
    {
      "coin": "BTC",
      "direction": "UP",
      "pnl_usdc": 3.21,
      "timestamp": "2026-03-13T04:00:00Z"
    }
  ],
  "bot": "Fishy",
  "platform": "Polymarket"
}

GET /token/{addr}

On-chain token scoring: liquidity, volume, holder count, age, risk rating.

GET /token/{addr}/diagnose

Claude Opus analyses the token on-chain metrics and gives a trade-readiness assessment.

GET /wallet/{addr}

Transaction history and behavioral analysis for any Base wallet.

📚 Code Examples

Full working examples (Python, Node.js, LangChain): GitHub repo

JavaScript — x402-axios SDK (Base)

import axios from 'axios';
import { wrapAxios } from 'x402-axios';

const client = wrapAxios(axios, {
  privateKey: process.env.PRIVATE_KEY,  // Base wallet private key
});

// Get live trading signals — pays $0.01 USDC automatically
const { data } = await client.get('https://api.deepbluebase.xyz/signals');
console.log(data.signals[0]);
// → { coin: 'BTC', direction: 'UP', confidence: 0.68, regime: 'momentum' }

// Token price — $0.001
const price = await client.get('https://api.deepbluebase.xyz/price/ETH');
console.log(price.data); // { token: 'ETH', price_usd: 2041.30, ... }

// BTC macro bundle — $0.01
const snap = await client.get('https://api.deepbluebase.xyz/market-snapshot');
console.log(snap.data); // { btc_price, signals, sentiment, funding_rate }

// Premium agent bundle — $0.05 (replaces 5+ calls, includes LLM-ready summary)
const pulse = await client.get('https://api.deepbluebase.xyz/agent-pulse');
console.log(pulse.data.agent_summary); // drop-in agent context, 1-2 sentences
console.log(pulse.data.coins, pulse.data.whales, pulse.data.hot_polymarket);

Python — x402 SDK (Base)

from x402.client import Client

client = Client(private_key=os.environ['PRIVATE_KEY'])  # Base wallet

# Get Polymarket prediction market intel — $0.01
r = client.get('https://api.deepbluebase.xyz/polymarket')
print(r.json())  # { markets: [...], hot_categories: [...] }

# AI token diagnosis — $0.01
r = client.get('https://api.deepbluebase.xyz/token/0xabc.../diagnose')
print(r.json()['analysis'])  # Claude Opus natural language report

Python — Manual x402 flow (no SDK)

import requests, json, base64

# Step 1: Hit endpoint, get 402 + payment requirements
r = requests.get('https://api.deepbluebase.xyz/signals')
# r.status_code == 402
# r.headers['X-Payment-Required'] contains base64 JSON with payment details

requirements = json.loads(base64.b64decode(r.headers['X-Payment-Required']))
# requirements['accepts'][0] = { network, amount, payTo, ... }

# Step 2: Sign payment via EIP-712 (use x402 SDK for helpers)

# Step 3: Retry with X-Payment header
r2 = requests.get(
    'https://api.deepbluebase.xyz/signals',
    headers={'X-Payment': your_signed_payment_header}
)
print(r2.json())

cURL — Check API status (free)

# API info and endpoint list (no payment needed)
curl https://api.deepbluebase.xyz/

# x402 status and settlement history
curl https://api.deepbluebase.xyz/x402/status

# Attempt paid call — will return 402 with payment requirements
curl -v https://api.deepbluebase.xyz/signals

🔐 x402 Payment Details

We implement x402 via the PayAI facilitator. Every endpoint returns payment requirements on unauthenticated requests.

Payment Requirements Structure

{
  "x402Version": 1,
  "resource": {
    "url": "https://api.deepbluebase.xyz/signals",
    "description": "Live Polymarket BTC/ETH/SOL/XRP trading signals",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "10000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x47ffc880cfF2e8F18fD9567faB5a1fBD217B5552",
      "maxTimeoutSeconds": 300
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "amount": "10000",
      "payTo": "BsSDrMtQeE3c8bPX2amVGdKTkLZrEwWMw6Yo949bx9ZD",
      "maxTimeoutSeconds": 300
    }
  ]
}

Amounts are in USDC atomic units (6 decimals). 10000 = $0.01.

💡 Use Cases

• AI Trading Agents: Feed real signals directly into autonomous decision loops
• Research Tools: Token analysis and trending discovery without rate limits
• Portfolio Trackers: Wallet scanning and risk assessment on-demand
• Strategy Backtesting: Access our real performance data to validate strategies
• DeFi Dashboards: Live pricing and pool data with no API key management

❓ FAQs

What networks are accepted?

Both Base USDC (chain 8453) and Solana USDC. The x402 SDK picks the right one automatically based on your wallet type.

Do I need to sign up?

No. Just have a wallet with USDC (Solana or Base). The x402 SDK handles everything automatically.

Is the trading data real?

Yes. Signals come directly from Fishy (our live Polymarket bot). Performance data is our actual P&L — verifiable on-chain.

What if a payment fails?

The request returns HTTP 402. Your wallet is not charged. Retry when your balance is sufficient.

Can AI agents use this autonomously?

Yes — that's the point. Use the x402-axios or x402 (Python) SDK to make any AI agent pay-per-call automatically. DeepBlue is listed on x402scan.com for AI agent discovery.

📞 Support

• API Status: api.deepbluebase.xyz/x402/status
• Discord: discord.gg/wpSKuA57bq
• X: @DeepBlueBase
• Dexter Marketplace: Our seller profile