# Octodamus Bull Trap Monitor

> Octodamus Bull Trap Monitor is a paid API for AI agents from api.octodamus.com, paid per call via x402, $0.35/call, status unknown (last checked 2026-09-13).

Returns a crypto trading signal (BUY/SELL/HOLD) with bull trap detection, BTC trend, fear/greed index, Polymarket edge, and reasoning for whether a current bullish move is a trap.

## Facts

- Endpoint: GET https://api.octodamus.com/v2/ben/bens_bull_trap_monitor
- Price: $0.35/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/octodamus-bull-trap-monitor-2dd20bc7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZkNGB7cwZriXYntms209g

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability octodamus-bull-trap-monitor-2dd20bc7
```

Example prompt: Check if the current crypto rally is a bull trap — give me the BUY/SELL/HOLD signal, the BTC trend, the fear and greed score, and your reasoning so I know whether to enter or stay out.

## When to prefer this

Use this endpoint when an agent needs a composite crypto trading signal specifically focused on bull trap detection — combining BTC trend, fear/greed, and Polymarket edge into a single BUY/SELL/HOLD recommendation. Prefer over raw sentiment or price feeds when you need opinionated, reasoned signal output. Best for agents making crypto trading decisions during apparent bull runs where false breakouts are a risk.

## Known failure modes

- Missing or invalid PAYMENT-SIGNATURE header returns 402 Payment Required
- Expired or already-used EIP-3009 payment signature returns 402
- Insufficient USDC balance on Base mainnet causes payment failure
- Network congestion on Base causing payment verification delays
- Endpoint may return stale data if upstream market data sources are unavailable

## How this service works

Octodamus Bull Trap Monitor -- pay-per-call x402 endpoint on Base. Preview: https://api.octodamus.com/v2/ben/bens_bull_trap_monitor/preview

## Output

Returns a JSON object with: action (BUY/SELL/HOLD), signal (BULLISH/BEARISH/NEUTRAL), btc_trend (UP/DOWN/SIDEWAYS), a numeric confidence score (0–1), fear_greed index (0–100), Polymarket edge data object, and a human-readable reasoning string explaining the bull trap assessment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "type": "string",
     "const": "GET"
    },
    "headers": {
     "type": "object",
     "required": [
      "PAYMENT-SIGNATURE"
     ],
     "properties": {
      "PAYMENT-SIGNATURE": {
       "type": "string",
       "description": "x402 EIP-3009 USDC payment signature (Base mainnet)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "action": {
     "enum": [
      "BUY",
      "SELL",
      "HOLD"
     ],
     "type": "string"
    },
    "signal": {
     "enum": [
      "BULLISH",
      "BEARISH",
      "NEUTRAL"
     ],
     "type": "string"
    },
    "btc_trend": {
     "enum": [
      "UP",
      "DOWN",
      "SIDEWAYS"
     ],
     "type": "string"
    },
    "reasoning": {
     "type": "string"
    },
    "confidence": {
     "type": "number",
     "maximum": 1,
     "minimum": 0
    },
    "fear_greed": {
     "type": "number",
     "maximum": 100,
     "minimum": 0
    },
    "polymarket_edge": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "action": "BUY",
  "signal": "BULLISH",
  "btc_trend": "UP",
  "reasoning": "Oracle 9/11 consensus bullish. Fear & Greed neutral-greed zone.",
  "confidence": 0.78,
  "fear_greed": 62,
  "polymarket_edge": {
   "ev": 0.14,
   "market": "BTC above 90k"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/octodamus-bull-trap-monitor-2dd20bc7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.octodamus.com](https://www.zero.xyz/host/api.octodamus.com/llms.txt)
