OlaXBT Nexus Data API Skill

Official OlaXBT Nexus Data API integration for OpenClaw agents. This skill uses a JWT only (no private key in the skill). Obtain the JWT via the Nexus auth flow; then set NEXUS_JWT and use the client.

• 🔐 JWT-only: No private key in the skill; use a pre-obtained JWT from the Nexus auth flow
• 📊 14 API Endpoints: Full coverage of OlaXBT Nexus data services
• ⚡ Real-time Data: Live market insights and analysis
• 🛡️ Minimal permissions: Only reads NEXUS_JWT and optional NEXUS_* URLs
• 📈 Advanced Analytics: Technical indicators and smart money tracking

# Install from ClawHub
openclaw skill install olaxbt-nexus-data

pip install olaxbt-nexus-data

# Obtain JWT via the Nexus auth flow (see skills/nexus/SKILL.md), then:
export NEXUS_JWT="<your-jwt-token>"

The OlaXBT Nexus API is HTTP. You can use it with any client (curl, fetch, Postman, etc.) by following the Nexus Skills API spec: POST /auth/message → sign the message with your wallet → POST /auth/wallet → get JWT → call https://api-data.olaxbt.xyz/api/v1/... with Authorization: Bearer <JWT>. No Python or OpenClaw required.

This repo is a Python wrapper for that same API. Use it if you want a pip install / openclaw skill install client instead of hand-rolling HTTP and signing. OpenClaw is an agent framework; it can use either the HTTP spec (curl-style) or this Python skill. Both talk to the same backend.

from olaxbt_nexus_data import NexusClient

# Set NEXUS_JWT in env (obtain via Nexus auth flow), then:
client = NexusClient()
client.authenticate()

# Get latest crypto news
news = client.news.get_latest(limit=10)
for item in news:
    print(f"📰 {item['title']}")

# Get market overview
market = client.market.get_overview()
print(f"📈 Total Market Cap: ${market['total_market_cap']:,.0f}")

# Get KOL heatmap for Bitcoin
kol_data = client.kol.get_heatmap(symbol="BTC")
print(f"👥 KOL Activity: {kol_data['total_mentions']} mentions")

• Auth Domain: https://api.olaxbt.xyz/api
• Data Domain: https://api-data.olaxbt.xyz/api/v1

The skill does not handle private keys. Get a JWT using the Nexus Skills API auth flow:

1. POST https://api.olaxbt.xyz/api/auth/message with {"address": "0x..."}
2. Sign the returned message with your wallet (e.g. OpenClaw or one-time sign-in)
3. POST https://api.olaxbt.xyz/api/auth/wallet with address, signature, message, nonce → receive token (JWT)
4. Set export NEXUS_JWT="<token>" and use the client

client = NexusClient()  # reads NEXUS_JWT from env
jwt = client.auth.get_token()

• No private key in skill: Only NEXUS_JWT (and optional NEXUS_AUTH_URL, NEXUS_DATA_URL) are read.
• Network: Only talks to api.olaxbt.xyz and api-data.olaxbt.xyz. No telemetry.
• HTTPS and rate limiting are enforced.

Check the examples/ directory for complete implementations:

Basic authentication and API calls demonstration.

Real-time news monitoring with filtering and alerts.

Comprehensive market analysis with multiple data sources.

Advanced wallet authentication and JWT management (obtain JWT outside the skill, then pass it in).

# Required
NEXUS_JWT="<your-jwt-from-nexus-auth-flow>"

# Optional
NEXUS_AUTH_URL="https://api.olaxbt.xyz/api"
NEXUS_DATA_URL="https://api-data.olaxbt.xyz/api/v1"

from olaxbt_nexus_data import NexusClient

client = NexusClient(
    jwt_token="...",  # optional, else uses NEXUS_JWT
    auth_url="https://api.olaxbt.xyz/api",
    data_url="https://api-data.olaxbt.xyz/api/v1",
    timeout=30,
    max_retries=3,
    rate_limit=1000,
)

from olaxbt_nexus_data import NexusClient, NexusError

client = NexusClient()

try:
    data = client.news.get_latest(limit=10)
except NexusError as e:
    print(f"API Error: {e.message}")
    print(f"Status Code: {e.status_code}")
except AuthenticationError as e:
    print(f"Authentication failed: {e.message}")
    # Re-authenticate or check credentials
except RateLimitError as e:
    print(f"Rate limit exceeded: {e.message}")
    print(f"Reset in: {e.reset_in} seconds")

# Install development dependencies
pip install olaxbt-nexus-data[dev]

# Run tests
pytest tests/

# Run with coverage
pytest --cov=olaxbt_nexus_data tests/

# Type checking
mypy src/

To publish this skill to ClawHub, see PUBLISHING.md for step-by-step instructions (account, CLI, permissions, and updates).

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

• Documentation: https://olaxbt.xyz/skill.md
• GitHub Issues: https://github.com/olaxbt/olaxbt-nexus-data/issues
• Email: hello@olaxbt.xyz

MIT License - See LICENSE file for details.

Official OlaXBT Skill • Enterprise Grade • Production Ready