Skip to main content

vextorium (Python)

550+ pay-per-call data services for trading bots and AI agents: perp funding, liquidation maps, Hyperliquid markets and whales, market regime, prices, on-chain data on 30+ chains, DeFi, official statistics and more.

No API keys, no sign-up. A Base wallet with a little USDC is the account; each call is paid automatically via x402 (typically $0.003–$0.01). Failed calls are not charged.

pip install "vextorium @ git+https://github.com/bru1noia/vextorium-python"
from vextorium import Vextorium

vx = Vextorium(private_key="0x...", budget_usd=1.0, max_price_usd=0.02)  # use a separate small wallet
vx.call("perp-funding", currency="BTC")        # funding, premium, open interest
vx.call("hyperliquid-liquidation-map", currency="ETH", brackets=10)
vx.call("market-regime")                       # risk-on / risk-off score
vx.services("funding")                         # free: search the catalog
print(vx.spent / 1e6, "USDC spent")

Safety: every call is capped by max_price_usd, the session by budget_usd (BudgetExceeded is raised before paying), payments only go out on Base USDC, and one payment runs at a time per wallet.

freqtrade

Add funding, nearest liquidations and market regime as columns (latest candle only, no look-ahead), cached so a bot calls each service at most once per refresh_minutes:

from vextorium.freqtrade import VextoriumContext

class MyStrategy(IStrategy):
    vx = VextoriumContext(budget_usd=2.0, refresh_minutes=60)   # key from VEXTORIUM_KEY

    def populate_indicators(self, dataframe, metadata):
        dataframe = self.vx.add_columns(dataframe, metadata["pair"])
        # vx_funding_annual_pct, vx_premium_pct, vx_open_interest_usd, vx_nearest_long_liq_pct,
        # vx_nearest_short_liq_pct, vx_long_at_risk_usd, vx_short_at_risk_usd, vx_regime_score
        return dataframe

Cost example: 1 pair, refresh 60 min, 3 signals ≈ 24 × 0.019 = 0.46 USDC/day.

Full catalog: https://api.vextorium.com/catalog.json · OpenAPI: https://api.vextorium.com/openapi.json · MCP server: https://github.com/bru1noia/vextorium-mcp

License: MIT

Metadata

Release files for vextorium 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vextorium 0.1.0
File Size Uploaded
vextorium-0.1.0.tar.gz 5.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for vextorium 0.1.0
File Interpreter ABI Platform
vextorium-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 11.7 kB

Release files / vextorium-0.1.0.tar.gz

Download URL vextorium-0.1.0.tar.gz
Size 5.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b0585e9dd9fc09178c82d1f7d12bfd14112cc0bed8716bcfa0969dcefb2fbef3
BLAKE2b-256 checksum
How to use checksums
0721aafdbfae4f9ad3b2d282dd676970d5b3acae0933f472d3abd04579e5b156
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release files / vextorium-0.1.0-py3-none-any.whl

Download URL vextorium-0.1.0-py3-none-any.whl
Size 6.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
94bd654ae7ae7599d75354643f1e19a4651d86781926b244401c73e9affed591
BLAKE2b-256 checksum
How to use checksums
524c88a66322847fbf37a0bcee20f9768ba03912f41b80e336ac16913bb4993f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release history Release notifications | RSS feed

0.1.2

2 release files

0.1.1

2 release files

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page