signalfuse

Python client for the SignalFuse trading intelligence API.

Fused signals combining sentiment, macro regime, and market structure for crypto markets.

Install

pip install signalfuse

Quick start

from signalfuse import SignalFuseClient

client = SignalFuseClient(credit_token="your-token")
signal = client.get_signal("BTC")
print(signal)

Get a free trial token

curl -X POST https://api.signalfuse.co/v1/credits/trial \
  -H "Content-Type: application/json" \
  -d '{"wallet": "0xYourWalletAddress"}'

Usage

Sync client

from signalfuse import SignalFuseClient

with SignalFuseClient(credit_token="your-token") as client:
    # Directional signal for a single asset
    signal = client.get_signal("ETH")

    # Batch signals for all supported assets
    signals = client.get_signals()

    # Sentiment breakdown
    sentiment = client.get_sentiment("BTC")

    # Macro risk regime
    regime = client.get_regime()

    # Strategy Arena
    leaderboard = client.get_arena_leaderboard()
    arena_signal = client.get_arena_signal("momentum_v1", "BTC")

    # Pricing info
    pricing = client.get_pricing()

Async client

import asyncio
from signalfuse import AsyncSignalFuseClient

async def main():
    async with AsyncSignalFuseClient(credit_token="your-token") as client:
        signal = await client.get_signal("BTC")
        regime = await client.get_regime()
        print(signal, regime)

asyncio.run(main())

Authentication

SignalFuse supports two payment modes:

1. Credit tokens (simplest) -- get 25 free trial calls, then buy packs (500 calls / $4, 5000 calls / $30).
2. x402 micropayments -- automatic per-call USDC payments on Base. See x402.org for details.

This SDK uses credit tokens. Pass your token when creating the client:

client = SignalFuseClient(credit_token="sf_abc123...")

API reference

License

MIT