DeepBlue Trading API | Documentation

🚀 Quick Start

The DeepBlue Trading API delivers live data from our autonomous trading system. Pay per call — no accounts, no subscriptions.

Real-time token prices from on-chain DeFi pools
Trending Base chain pools with volume & momentum scores
Live Polymarket BTC/ETH/SOL/XRP trading signals (from Fishy bot)
Our actual live trading performance & P&L
AI token analysis powered by Claude Opus

No subscriptions. No accounts. Pay per call in USDC.

View Pricing Code Examples

📡 How x402 Payments Work

We use x402 v2 via the Dexter facilitator. Your agent pays automatically — no manual steps.

Request: Your agent calls any endpoint
402 Response: API returns payment requirements (amount, wallet, network)
Auto-pay: x402 SDK signs and sends USDC — Solana or Base
Data: Request retries and succeeds instantly

Two payment networks accepted:
• Solana USDC → BsSDrMtQeE3c8bPX2amVGdKTkLZrEwWMw6Yo949bx9ZD
• Base USDC → 0x47ffc880cfF2e8F18fD9567faB5a1fBD217B5552
The x402 SDK picks the right network automatically based on your wallet.

💰 Pricing

Endpoint	Price	What You Get
`GET /price/{token}`	$0.02	Real-time token price, 24h change, volume from DeFi pools
`GET /trending`	$0.05	Top 10 trending pools on Base with momentum scores
`GET /token/{addr}`	$0.10	Token scoring, liquidity, holder metrics, risk rating
`GET /token/{addr}/diagnose`	$0.10	Claude Opus AI deep-dive analysis with trade readiness
`GET /wallet/{addr}`	$0.15	Wallet transaction history, behavioral analysis, risk scan
`GET /signals`	$0.20	Live BTC/ETH/SOL/XRP signals from our Polymarket bot
`GET /performance`	$0.25	Our real P&L, win rate, trade history, on-chain proof

🔌 Endpoints

GET /price/{token}

GET https://api.deepbluebase.xyz/price/{token}

Price: $0.02 USDC

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

Request:

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

Response:

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

GET /trending

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

Price: $0.05 USDC

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

Request:

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

Response:

{
  "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

GET https://api.deepbluebase.xyz/signals

Price: $0.20 USDC | Live Bot Output

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.

Response:

{
  "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

GET https://api.deepbluebase.xyz/performance

Price: $0.25 USDC | On-chain Verifiable

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

Response:

{
  "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}

GET https://api.deepbluebase.xyz/token/{addr}

Price: $0.10 USDC

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

GET /token/{addr}/diagnose

GET https://api.deepbluebase.xyz/token/{addr}/diagnose

Price: $0.10 USDC | Claude Opus AI

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

GET /wallet/{addr}

GET https://api.deepbluebase.xyz/wallet/{addr}

Price: $0.15 USDC

Transaction history and behavioral analysis for any Base wallet.

📚 Code Examples

JavaScript — Dexter x402 SDK (EVM/Base)

import { wrapFetch } from '@dexterai/x402/client';

const x402Fetch = wrapFetch(globalThis.fetch, {
  evmPrivateKey: process.env.PRIVATE_KEY,  // Base wallet
  preferredNetwork: 'eip155:8453',
  rpcUrls: { 'eip155:8453': 'https://mainnet.base.org' },
});

// Pays $0.02 USDC automatically, then returns data
const res = await x402Fetch('https://api.deepbluebase.xyz/price/ETH');
const data = await res.json();
console.log(data); // { token: 'ETH', price_usd: 2041.30, ... }

// Get live trading signals ($0.20)
const sig = await x402Fetch('https://api.deepbluebase.xyz/signals');
const signals = await sig.json();
console.log(signals.signals[0]); // { coin: 'BTC', direction: 'UP', confidence: 0.68 }

Python — Manual x402 v2 (Base)

import requests, json, base64
from eth_account import Account
from eth_account.structured_data import make_domain

# Step 1: Hit endpoint, get 402 + payment requirements
r = requests.get('https://api.deepbluebase.xyz/signals')
assert r.status_code == 402

requirements = json.loads(base64.b64decode(r.headers['PAYMENT-REQUIRED']))
accept = next(a for a in requirements['accepts'] if a['network'] == 'eip155:8453')

# Step 2: Sign EIP-712 payment
# (see @dexterai/x402 SDK for full signing helper)

# Step 3: Retry with payment-signature header
r2 = requests.get(
    'https://api.deepbluebase.xyz/signals',
    headers={'payment-signature': your_signed_payload}
)
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 v2 Payment Details

We implement x402 v2 via the Dexter facilitator. Every endpoint returns a PAYMENT-REQUIRED header (base64 JSON) on unauthenticated requests.

Payment Requirements Structure

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

Amounts are in USDC atomic units (6 decimals). 200000 = $0.20.

📚 Resources: Dexter Marketplace — x402 Docs — @dexterai/x402 SDK

💡 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 Solana USDC and Base USDC. The Dexter 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 @dexterai/x402 SDK's wrapFetch() to make any AI agent pay-per-call automatically.

📞 Support

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