elizaos-plugin-deepblue

Real-time crypto trading signals for ElizaOS agents, powered by the DeepBlue x402 API.

Your agent gets live BTC/ETH/SOL/XRP signals, market mood (fear/greed), and Polymarket position data — all via pay-per-call micropayments on Base using the x402 protocol.

Features

• BTC Signal — Real-time direction (UP/DOWN), confidence %, price, order book imbalance
• Market Mood — Fear/greed index, regime, per-asset bias for BTC/ETH/SOL/XRP
• All Signals — Multi-coin signal sweep in a single call
• Market Data Provider — Automatically injects current market context into every agent response (cached 60s)
• x402 aware — Gracefully handles payment-required (402) responses with helpful messaging

Install

npm install elizaos-plugin-deepblue

Usage

Register in your character file

{
  "name": "MyAgent",
  "plugins": ["elizaos-plugin-deepblue"],
  "settings": {}
}

Register in code

import { createAgent } from "@elizaos/core";
import deepbluePlugin from "elizaos-plugin-deepblue";

const agent = await createAgent({
  character: myCharacter,
  plugins: [deepbluePlugin],
});

Actions

GET_BTC_SIGNAL

Triggers on: "BTC signal", "what is BTC doing", "should I buy BTC", "bitcoin direction", etc.

Calls GET /btc/realtime-signal?coin=btc and returns:

📈 BTC Signal: UP (Moderate)

• Direction: UP
• Confidence: 62%
• Current Price: $67,420
• Momentum: +0.15%
• Order Book: buy-side pressure (imbalance: 0.214)

Powered by DeepBlue — https://deepbluebase.xyz

Cost: 0.005 USDC per call (x402, USDC on Base)

GET_MARKET_MOOD

Triggers on: "market mood", "fear and greed", "market sentiment", "how is the market", etc.

Calls GET /market-mood and returns:

🌊 Market Mood Report

• Regime: bull_volatile
• Fear/Greed Index: 72/100 — Greed 😏

Per-Asset Bias:
  • BTC: 📈 UP | Momentum: +0.21%
  • ETH: 📈 UP | Momentum: +0.15%
  • SOL: ➡️ NEUTRAL | Momentum: -0.02%
  • XRP: 📉 DOWN | Momentum: -0.18%

Powered by DeepBlue — https://deepbluebase.xyz

Cost: 0.01 USDC per call (x402, USDC on Base)

GET_SIGNALS

Triggers on: "trading signals", "all signals", "what's moving", "signal summary", etc.

Calls GET /signals and returns a ranked multi-coin signal table.

Cost: 0.005 USDC per call (x402, USDC on Base)

Market Data Provider

The plugin automatically registers a provider that injects current market context into every agent response (no extra configuration needed):

Current market (DeepBlue): BTC BULLISH | Fear/Greed: 72/100 (greed) | Regime: bull_volatile | Other: ETH bullish, SOL neutral, XRP bearish

The provider caches results for 60 seconds to avoid hammering the API.

x402 Payments

DeepBlue uses the x402 protocol for micropayments. When an endpoint requires payment:

1. The API returns HTTP 402 Payment Required with payment details
2. The plugin catches this gracefully and tells the user: "This signal requires a micropayment (~0.005 USDC) via the x402 protocol (USDC on Base)."
3. No crashes, no unhandled errors

To enable paid calls, your agent or application needs an x402-capable HTTP client with a funded Base wallet. See x402.org for client libraries.

API Reference

All endpoints are at https://api.deepbluebase.xyz:

| Endpoint | Description | Cost | |---|---|---| | GET /btc/realtime-signal?coin=btc | Real-time BTC signal | 0.005 USDC | | GET /market-mood | Fear/greed + regime | 0.01 USDC | | GET /signals | All-coin signal sweep | 0.005 USDC | | GET /performance | Win rate + P&L | 0.01 USDC | | GET /polymarket | Active positions | 0.01 USDC |

Links

• Website: https://deepbluebase.xyz
• GitHub: https://github.com/ERROR403agent/elizaos-plugin-deepblue
• x402 Protocol: https://x402.org

License

MIT