Adriano
bc75d3980a
Add a common cross-exchange interface (/mcp) over the integrated venues
(deribit, hyperliquid):
- get_instruments: uniform schema where each row carries its own
`exchange`, `fees` (maker/taker, live from Deribit, null where the
venue has no per-instrument schedule) and `history_start` (listing
date, live from Deribit creation_timestamp), plus type/tick_size and a
lossless `native` blob. Optional `exchange` filter; fan-out otherwise.
- get_historical: generalized to {exchange, instrument, interval,
start_date, end_date}, returning a single chosen venue's candles.
Consensus merge stays available on /mcp-cross.
New: routers/unified.py, exchanges/cross/instruments.py (normalizers),
UnifiedClient in cross/client.py, schemas in cross/tools.py. Deribit
get_instruments now also surfaces maker/taker_commission and
creation_timestamp (additive).
Retire Bybit and Alpaca from the API surface: move clients, routers,
settings classes and their tests under old/ (history preserved via
git mv); drop them from the builder, /mcp-cross dispatch and symbol_map.
Bybit remains a public funding/OI data source in sentiment (not the
trading client). IBKR is intentionally excluded from /mcp for now.
Docs: rewrite API_REFERENCE.md (remove Bybit/Alpaca, document /mcp,
clarify that data_timestamp is injected globally by middleware).
Tests: add unified-interface coverage; update cross/settings/builder/boot
tests for the reduced venue set. Fix a pre-existing flaky assertion in
the Hyperliquid signing test (r/s use eth_utils.to_hex like the official
SDK, so a leading zero byte yields <66 chars ~1/256 of the time).
323 passed, ruff clean.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
76 lines
3.0 KiB
Python
76 lines
3.0 KiB
Python
"""Builder centralizzato di client per ClientRegistry."""
|
|
from __future__ import annotations
|
|
|
|
from typing import Literal
|
|
|
|
from cerbero_mcp.settings import Settings
|
|
|
|
Environment = Literal["testnet", "mainnet"]
|
|
|
|
|
|
async def build_client(
|
|
settings: Settings, exchange: str, env: Environment
|
|
):
|
|
if exchange == "deribit":
|
|
from cerbero_mcp.exchanges.deribit.client import DeribitClient
|
|
|
|
url = settings.deribit.url_testnet if env == "testnet" else settings.deribit.url_live
|
|
cid, csec = settings.deribit.credentials(env)
|
|
return DeribitClient(
|
|
client_id=cid,
|
|
client_secret=csec,
|
|
testnet=(env == "testnet"),
|
|
base_url_override=url,
|
|
)
|
|
if exchange == "hyperliquid":
|
|
from cerbero_mcp.exchanges.hyperliquid.client import HyperliquidClient
|
|
|
|
url = settings.hyperliquid.url_testnet if env == "testnet" else settings.hyperliquid.url_live
|
|
return HyperliquidClient(
|
|
wallet_address=settings.hyperliquid.wallet_address,
|
|
private_key=settings.hyperliquid.private_key.get_secret_value(),
|
|
testnet=(env == "testnet"),
|
|
api_wallet_address=settings.hyperliquid.api_wallet_address,
|
|
base_url=url,
|
|
)
|
|
if exchange == "macro":
|
|
# Read-only data provider — env ignored. Il registry
|
|
# istanzia comunque 2 entry (testnet/mainnet); costo trascurabile
|
|
# (wrapper stateless senza HTTP session).
|
|
from cerbero_mcp.exchanges.macro.client import MacroClient
|
|
|
|
return MacroClient(
|
|
fred_api_key=settings.macro.fred_api_key.get_secret_value(),
|
|
finnhub_api_key=settings.macro.finnhub_api_key.get_secret_value(),
|
|
)
|
|
if exchange == "sentiment":
|
|
# Read-only data provider — env ignored (CryptoPanic, LunarCrush e
|
|
# endpoint pubblici di funding/OI multi-exchange sono unici).
|
|
from cerbero_mcp.exchanges.sentiment.client import SentimentClient
|
|
|
|
return SentimentClient(
|
|
cryptopanic_key=settings.sentiment.cryptopanic_key.get_secret_value(),
|
|
lunarcrush_key=settings.sentiment.lunarcrush_key.get_secret_value(),
|
|
)
|
|
if exchange == "ibkr":
|
|
from cerbero_mcp.exchanges.ibkr.client import IBKRClient
|
|
from cerbero_mcp.exchanges.ibkr.oauth import OAuth1aSigner
|
|
|
|
creds = settings.ibkr.credentials(env)
|
|
url = settings.ibkr.url_testnet if env == "testnet" else settings.ibkr.url_live
|
|
signer = OAuth1aSigner(
|
|
consumer_key=creds["consumer_key"],
|
|
access_token=creds["access_token"],
|
|
access_token_secret=creds["access_token_secret"],
|
|
signature_key_path=creds["signature_key_path"],
|
|
encryption_key_path=creds["encryption_key_path"],
|
|
dh_prime=creds["dh_prime"],
|
|
)
|
|
return IBKRClient(
|
|
signer=signer,
|
|
account_id=creds["account_id"],
|
|
paper=(env == "testnet"),
|
|
base_url=url,
|
|
)
|
|
raise ValueError(f"unsupported exchange: {exchange}")
|