GET /bundle/{coin}

GET /bundle/{coin}

$0.05 USDC Best Value

Returns pulse technical analysis, sentiment, funding, and spread data in a single response. 9% cheaper than calling all four endpoints individually ($0.05 vs $0.055 = $0.025 + $0.01 + $0.01 + $0.015).

Request

GET https://api.cerebruspulse.xyz/bundle/{coin}

Path Parameters

Parameter	Type	Required	Description
coin	string	Yes	Coin ticker (e.g., BTC, ETH). Case-insensitive.

Query Parameters

Parameter	Type	Default	Description
timeframes	string	1h,4h	Comma-separated timeframes. Valid: 5m, 15m, 1h, 4h, 1d, 1w.

Response

The response combines all four endpoint responses under top-level keys:

Field	Type	Description
coin	string	Coin ticker
timestamp_iso	string	ISO 8601 timestamp
pulse	object	Full pulse analysis (same as /pulse/{coin} response)
sentiment	object	Sentiment data (same as /sentiment response)
funding	object	Funding analysis (same as /funding/{coin} response)
spread	object	Spread & liquidity data (same as /spread/{coin} response)
meta	object	Provider metadata with bundle info

Example

GET /bundle/BTC?timeframes=1h,4h

{
  "coin": "BTC",
  "timestamp_iso": "2026-03-02T14:30:00Z",
  "pulse": {
    "price": { "current": 98765.43 },
    "timeframes": {
      "1h": { "indicators": { "rsi_14": 65.4, "rsi_zone": "bullish", "..." : "..." } },
      "4h": { "indicators": { "rsi_14": 58.1, "rsi_zone": "neutral", "..." : "..." } }
    },
    "derivatives": { "funding_rate": 0.000125, "open_interest": 1850000000, "..." : "..." },
    "regime": { "current": "RISK_ON", "as_of": 1740939296 },
    "confluence": { "score": 0.75, "bias": "bullish", "..." : "..." }
  },
  "sentiment": {
    "overall": "bullish",
    "score": 0.68,
    "labels": { "fear_greed": "greed", "momentum": "positive", "funding_bias": "long" }
  },
  "funding": {
    "current_rate": 0.000125,
    "annualized_pct": 13.65,
    "lookback_hours": 24,
    "history": [ "..." ]
  },
  "meta": {
    "provider": "Cerebrus Pulse",
    "offering": "cerebrus_pulse",
    "bundle": true,
    "execution_ms": 340,
    "discount_pct": 20
  }
}

When to Use Bundle

• Use bundle when you need a complete market view for a single coin — saves one payment round-trip and costs less.
• Use individual endpoints when you only need one type of data, or when querying sentiment (which isn’t coin-specific).

Errors

Status	Reason
400	Invalid coin
402	Payment required (standard x402 flow)
429	Rate limit exceeded
504	Engine timeout