Metadata-Version: 2.4
Name: langchain-cerebrus-pulse
Version: 0.3.0
Summary: LangChain tools for Cerebrus Pulse crypto intelligence API
Project-URL: Homepage, https://cerebruspulse.xyz
Project-URL: Documentation, https://cerebruspulse.xyz/overview
Project-URL: Repository, https://github.com/0xsl1m/langchain-cerebrus-pulse
Author-email: 0xsl1m <sl1m@ghost.love>
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agent,cerebrus-pulse,crypto,hyperliquid,langchain,technical-analysis,tools,trading
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: cerebrus-pulse>=0.1.0
Requires-Dist: langchain-core>=0.2.0
Description-Content-Type: text/markdown

# LangChain Cerebrus Pulse

LangChain tools for [Cerebrus Pulse](https://cerebruspulse.xyz) — real-time crypto intelligence for AI agents.

## Install

```bash
pip install langchain-cerebrus-pulse
```

## Quick Start

```python
from langchain_cerebrus_pulse import (
    CerebrusPulseTool,
    CerebrusSentimentTool,
    CerebrusFundingTool,
    CerebrusBundleTool,
    CerebrusListCoinsTool,
    CerebrusScreenerTool,
    CerebrusOITool,
    CerebrusSpreadTool,
    CerebrusCorrelationTool,
)

# Add to your agent's tools
tools = [
    CerebrusListCoinsTool(),      # Free
    CerebrusPulseTool(),          # $0.02/query
    CerebrusSentimentTool(),      # $0.01/query
    CerebrusFundingTool(),        # $0.01/query
    CerebrusBundleTool(),         # $0.04/query
    CerebrusScreenerTool(),       # $0.04/query — scan all coins
    CerebrusOITool(),             # $0.01/query
    CerebrusSpreadTool(),         # $0.008/query
    CerebrusCorrelationTool(),    # $0.03/query
]
```

## With a LangChain Agent

```python
from langchain_openai import ChatOpenAI
from langchain.agents import AgentExecutor, create_tool_calling_agent
from langchain_core.prompts import ChatPromptTemplate
from langchain_cerebrus_pulse import CerebrusPulseTool, CerebrusBundleTool, CerebrusListCoinsTool

llm = ChatOpenAI(model="gpt-4o")
tools = [CerebrusListCoinsTool(), CerebrusPulseTool(), CerebrusBundleTool()]

prompt = ChatPromptTemplate.from_messages([
    ("system", "You are a crypto analyst with access to real-time Hyperliquid data via Cerebrus Pulse."),
    ("human", "{input}"),
    ("placeholder", "{agent_scratchpad}"),
])

agent = create_tool_calling_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools)

result = executor.invoke({"input": "What's the technical outlook for BTC and ETH?"})
print(result["output"])
```

## Available Tools

| Tool | Cost | Description |
|------|------|-------------|
| `CerebrusListCoinsTool` | Free | List 30+ available Hyperliquid perpetuals |
| `CerebrusPulseTool` | $0.02 | Technical analysis (RSI, EMAs, Bollinger, trend, regime, confluence) |
| `CerebrusSentimentTool` | $0.01 | Market sentiment (fear/greed, momentum, funding bias) |
| `CerebrusFundingTool` | $0.01 | Funding rates with historical data |
| `CerebrusBundleTool` | $0.04 | All data combined (20% discount) |
| `CerebrusScreenerTool` | $0.04 | Scan 30+ coins: signals, trends, vol regime, confluence |
| `CerebrusOITool` | $0.01 | Open interest: delta, percentile, trend, divergence |
| `CerebrusSpreadTool` | $0.008 | Spread: slippage estimates at various sizes, liquidity score |
| `CerebrusCorrelationTool` | $0.03 | BTC-alt correlation matrix with regime classification |

## Links

- [Cerebrus Pulse Docs](https://cerebruspulse.xyz/overview)
- [Python SDK](https://github.com/0xsl1m/cerebrus-pulse-python)
- [MCP Server](https://github.com/0xsl1m/cerebrus-pulse-mcp)

## Disclaimer

Cerebrus Pulse provides market data and technical indicators for **informational purposes only**. Nothing provided by these tools or the underlying API constitutes financial advice, investment advice, or trading advice. AI-generated analysis, signals, and sentiment labels are algorithmic outputs — not recommendations to buy, sell, or hold any asset. Cryptocurrency trading involves substantial risk of loss. You are solely responsible for your own trading decisions.

## License

MIT
