Metadata-Version: 2.4
Name: langchain-signalfuse
Version: 0.1.2
Summary: LangChain tools for the SignalFuse crypto trading signal API
Project-URL: Homepage, https://signalfuse.co
Project-URL: Repository, https://github.com/signalfuse/langchain-signalfuse
Author-email: SignalFuse <hello@signalfuse.co>
License-Expression: MIT
License-File: LICENSE
Keywords: crypto,langchain,signalfuse,signals,trading
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.9
Requires-Dist: langchain-core>=0.1.0
Requires-Dist: requests>=2.28.0
Description-Content-Type: text/markdown

# langchain-signalfuse

LangChain tools for the [SignalFuse](https://signalfuse.co) crypto trading signal API.

## Install

```bash
pip install langchain-signalfuse
```

## Usage

```python
from langchain_signalfuse import SignalFuseTool, MacroRegimeTool

tools = [
    SignalFuseTool(credit_token="your-token"),
    MacroRegimeTool(credit_token="your-token"),
]

# Drop into any LangChain agent
from langchain.agents import initialize_agent, AgentType

agent = initialize_agent(tools, llm, agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION)
agent.run("What's the current signal for ETH?")
```

### SignalFuseTool

Returns a fused directional signal for a given crypto asset (e.g. BTC, ETH, SOL), including signal strength, direction, confidence, and macro regime.

### MacroRegimeTool

Returns the current macro risk regime (`risk_on` / `risk_off` / `neutral`) for portfolio-level decisions.

## API

Base URL: `https://api.signalfuse.co`

Get 25 free credits (no signup):
```bash
curl -X POST https://api.signalfuse.co/v1/credits/trial \
  -H "Content-Type: application/json" \
  -d '{"wallet":"YOUR_ETH_ADDRESS"}'
```

This tool uses credit tokens for authentication. For x402 per-call payment (automatic USDC on Base), use the [starter bot](https://github.com/hypeprinter007-stack/hyperliquid-starter-bot) which has full x402 SDK integration.

## Disclaimer

SignalFuse provides a data fusion API, not financial advice. Signals are mathematical composites that can be wrong. Trade at your own risk.
