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>
157 lines
5.1 KiB
Python
157 lines
5.1 KiB
Python
from __future__ import annotations
|
|
|
|
import pytest
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_build_client_deribit_returns_correct_url(monkeypatch):
|
|
from tests.unit.test_settings import _minimal_env
|
|
|
|
for k, v in _minimal_env().items():
|
|
monkeypatch.setenv(k, v)
|
|
|
|
from cerbero_mcp.exchanges import build_client
|
|
from cerbero_mcp.settings import Settings
|
|
|
|
s = Settings()
|
|
c_test = await build_client(s, "deribit", "testnet")
|
|
c_live = await build_client(s, "deribit", "mainnet")
|
|
|
|
# DeribitClient espone base_url come property derivata da self.testnet
|
|
assert "test" in c_test.base_url.lower()
|
|
assert "test" not in c_live.base_url.lower()
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_build_client_hyperliquid_returns_correct_env(monkeypatch):
|
|
from tests.unit.test_settings import _minimal_env
|
|
|
|
for k, v in _minimal_env().items():
|
|
monkeypatch.setenv(k, v)
|
|
|
|
from cerbero_mcp.exchanges import build_client
|
|
from cerbero_mcp.settings import Settings
|
|
|
|
s = Settings()
|
|
c_test = await build_client(s, "hyperliquid", "testnet")
|
|
c_live = await build_client(s, "hyperliquid", "mainnet")
|
|
|
|
assert c_test is not c_live
|
|
assert c_test.testnet is True
|
|
assert c_live.testnet is False
|
|
assert "test" in c_test.base_url.lower()
|
|
assert "test" not in c_live.base_url.lower()
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_build_client_macro_no_env_distinction(monkeypatch):
|
|
from tests.unit.test_settings import _minimal_env
|
|
|
|
for k, v in _minimal_env().items():
|
|
monkeypatch.setenv(k, v)
|
|
|
|
from cerbero_mcp.exchanges import build_client
|
|
from cerbero_mcp.exchanges.macro.client import MacroClient
|
|
from cerbero_mcp.settings import Settings
|
|
|
|
s = Settings()
|
|
c_test = await build_client(s, "macro", "testnet")
|
|
c_live = await build_client(s, "macro", "mainnet")
|
|
|
|
# entrambi sono MacroClient validi (env ignorato)
|
|
assert isinstance(c_test, MacroClient)
|
|
assert isinstance(c_live, MacroClient)
|
|
# Stesse credenziali (env ignorato)
|
|
assert c_test.fred_api_key == c_live.fred_api_key
|
|
assert c_test.finnhub_api_key == c_live.finnhub_api_key
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_build_client_sentiment_no_env_distinction(monkeypatch):
|
|
from tests.unit.test_settings import _minimal_env
|
|
|
|
for k, v in _minimal_env().items():
|
|
monkeypatch.setenv(k, v)
|
|
|
|
from cerbero_mcp.exchanges import build_client
|
|
from cerbero_mcp.exchanges.sentiment.client import SentimentClient
|
|
from cerbero_mcp.settings import Settings
|
|
|
|
s = Settings()
|
|
c_test = await build_client(s, "sentiment", "testnet")
|
|
c_live = await build_client(s, "sentiment", "mainnet")
|
|
|
|
# entrambi sono SentimentClient validi (env ignorato)
|
|
assert isinstance(c_test, SentimentClient)
|
|
assert isinstance(c_live, SentimentClient)
|
|
# Stesse credenziali (env ignorato)
|
|
assert c_test.cryptopanic_key == c_live.cryptopanic_key
|
|
assert c_test.lunarcrush_key == c_live.lunarcrush_key
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_deribit_url_from_env_overrides_default(monkeypatch):
|
|
"""DERIBIT_URL_TESTNET custom nel .env → builder lo passa al client."""
|
|
from tests.unit.test_settings import _minimal_env
|
|
|
|
env = _minimal_env(DERIBIT_URL_TESTNET="https://custom-test.example.com/api/v2")
|
|
for k, v in env.items():
|
|
monkeypatch.setenv(k, v)
|
|
|
|
from cerbero_mcp.exchanges import build_client
|
|
from cerbero_mcp.settings import Settings
|
|
|
|
s = Settings()
|
|
c = await build_client(s, "deribit", "testnet")
|
|
assert c.base_url == "https://custom-test.example.com/api/v2"
|
|
assert "custom-test.example.com" in c.base_url
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_deribit_url_live_from_env_overrides_default(monkeypatch):
|
|
from tests.unit.test_settings import _minimal_env
|
|
|
|
env = _minimal_env(DERIBIT_URL_LIVE="https://custom-live.example.com/api/v2")
|
|
for k, v in env.items():
|
|
monkeypatch.setenv(k, v)
|
|
|
|
from cerbero_mcp.exchanges import build_client
|
|
from cerbero_mcp.settings import Settings
|
|
|
|
s = Settings()
|
|
c = await build_client(s, "deribit", "mainnet")
|
|
assert c.base_url == "https://custom-live.example.com/api/v2"
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_hyperliquid_url_from_env_overrides_default(monkeypatch):
|
|
from tests.unit.test_settings import _minimal_env
|
|
|
|
env = _minimal_env(HYPERLIQUID_URL_TESTNET="https://hl-custom.example.com")
|
|
for k, v in env.items():
|
|
monkeypatch.setenv(k, v)
|
|
|
|
from cerbero_mcp.exchanges import build_client
|
|
from cerbero_mcp.settings import Settings
|
|
|
|
s = Settings()
|
|
c = await build_client(s, "hyperliquid", "testnet")
|
|
assert c.base_url == "https://hl-custom.example.com"
|
|
# SDK override deve essere disponibile per init lazy
|
|
assert c._base_url_override == "https://hl-custom.example.com"
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_build_client_unknown_exchange_raises(monkeypatch):
|
|
from tests.unit.test_settings import _minimal_env
|
|
|
|
for k, v in _minimal_env().items():
|
|
monkeypatch.setenv(k, v)
|
|
|
|
from cerbero_mcp.exchanges import build_client
|
|
from cerbero_mcp.settings import Settings
|
|
|
|
s = Settings()
|
|
with pytest.raises(ValueError):
|
|
await build_client(s, "ftx", "testnet")
|