A comprehensive Python client for the AxiomTrade API with automatic token management, secure authentication, and extensive trading analytics for Solana meme tokens.
Project description
AxiomTradeAPI-py
The Professional Python SDK for Solana Trading on Axiom Trade
Build advanced trading bots, monitor portfolios, and automate Solana DeFi strategies with enterprise-grade reliability
๐ Documentation โข ๐ Quick Start โข ๐ฌ Discord โข ๐ Professional Services
๐ Why AxiomTradeAPI-py?
AxiomTradeAPI-py is the most comprehensive Python library for Solana trading automation, trusted by professional traders and DeFi developers worldwide. Whether you're building trading bots, portfolio trackers, or DeFi analytics tools, our SDK provides everything you need.
โก Key Features
| Feature | Description | Use Case |
|---|---|---|
| ๐ Real-time WebSocket | Sub-millisecond token updates | Token sniping, live monitoring |
| ๐ Portfolio Tracking | Multi-wallet balance monitoring | Portfolio management, analytics |
| ๐ค Trading Automation | Advanced bot frameworks | Automated trading strategies |
| ๐ Enterprise Security | Production-grade authentication | Secure API access |
| ๐ Market Data | Comprehensive Solana market info | Price feeds, volume analysis |
| ๐ก๏ธ Risk Management | Built-in trading safeguards | Position sizing, loss limits |
๐ Quick Start
Installation
# Install from PyPI
pip install axiomtradeapi
# Or install with development dependencies
pip install axiomtradeapi[dev]
# Verify installation
python -c "from axiomtradeapi import AxiomTradeClient; print('โ
Installation successful!')"
Basic Usage
New Token-Based Authentication (Recommended)
from axiomtradeapi import AxiomTradeClient
# Initialize client (no credentials required in constructor)
client = AxiomTradeClient()
# Method 1: Login to get tokens
tokens = client.login(
email="your_email@example.com",
b64_password="your_base64_encoded_password",
otp_code="123456" # OTP from email
)
print(f"Access Token: {tokens['access_token']}")
print(f"Refresh Token: {tokens['refresh_token']}")
# Method 2: Use existing tokens
client.set_tokens(
access_token="your_access_token_here",
refresh_token="your_refresh_token_here"
)
# Use the API
if client.is_authenticated():
trending = client.get_trending_tokens('1h')
print(f"Found {len(trending.get('tokens', []))} trending tokens")
Environment Variables (Production)
import os
from axiomtradeapi import AxiomTradeClient
# Secure authentication with environment variables
client = AxiomTradeClient()
client.set_tokens(
access_token=os.getenv('AXIOM_ACCESS_TOKEN'),
refresh_token=os.getenv('AXIOM_REFRESH_TOKEN')
)
# Your trading logic here
portfolio = client.get_user_portfolio()
Advanced Features
Real-time Token Monitoring
import asyncio
from axiomtradeapi import AxiomTradeClient
async def token_monitor():
client = AxiomTradeClient(
auth_token="your-auth-token",
refresh_token="your-refresh-token"
)
async def handle_new_tokens(tokens):
for token in tokens:
print(f"๐จ New Token: {token['tokenName']} - ${token['marketCapSol']} SOL")
await client.subscribe_new_tokens(handle_new_tokens)
await client.ws.start()
# Run the monitor
asyncio.run(token_monitor())
Batch Portfolio Tracking
# Monitor multiple wallets efficiently
wallets = [
"BJBgjyDZx5FSsyJf6bFKVXuJV7DZY9PCSMSi5d9tcEVh",
"Cpxu7gFhu3fDX1eG5ZVyiFoPmgxpLWiu5LhByNenVbPb",
"DsHk4F6QNTK6RdTmaDSKeFzGXMnQ9QxKTkDkG8XF8F4F"
]
balances = client.GetBatchedBalance(wallets)
total_sol = sum(b['sol'] for b in balances.values() if b)
print(f"๐ Total Portfolio: {total_sol:.6f} SOL")
๐ Comprehensive Documentation
Our documentation covers everything from basic setup to advanced trading strategies:
| Guide | Description | Skill Level |
|---|---|---|
| ๐ฅ Installation | Setup, requirements, troubleshooting | Beginner |
| ๐ Authentication | API keys, security, token management | Beginner |
| ๐ฐ Balance Queries | Wallet monitoring, portfolio tracking | Intermediate |
| ๐ก WebSocket Guide | Real-time data, streaming APIs | Intermediate |
| ๐ค Trading Bots | Automated strategies, bot frameworks | Advanced |
| โก Performance | Optimization, scaling, monitoring | Advanced |
| ๐ก๏ธ Security | Best practices, secure deployment | All Levels |
๐ Professional Use Cases
๐ฏ Token Sniping Bots
# High-speed token acquisition on new launches
class TokenSniperBot:
def __init__(self):
self.client = AxiomTradeClient(auth_token="...")
self.min_liquidity = 10.0 # SOL
self.target_profit = 0.20 # 20%
async def analyze_token(self, token_data):
if token_data['liquiditySol'] > self.min_liquidity:
return await self.execute_snipe(token_data)
๐ DeFi Portfolio Analytics
# Track yield farming and LP positions
class DeFiTracker:
def track_yields(self, positions):
total_yield = 0
for position in positions:
balance = self.client.GetBalance(position['wallet'])
yield_pct = (balance['sol'] - position['initial']) / position['initial']
total_yield += yield_pct
return total_yield
๐ Arbitrage Detection
# Find profitable price differences across DEXs
class ArbitrageBot:
def scan_opportunities(self):
# Compare prices across Raydium, Orca, Serum
opportunities = self.find_price_differences()
return [op for op in opportunities if op['profit'] > 0.005] # 0.5%
๐ ๏ธ Development & Contribution
Development Setup
# Clone repository
git clone https://github.com/ChipaDevTeam/AxiomTradeAPI-py.git
cd AxiomTradeAPI-py
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install development dependencies
pip install -e .[dev]
# Run tests
pytest tests/
Testing Your Installation
#!/usr/bin/env python3
"""Test script to verify AxiomTradeAPI-py installation"""
async def test_installation():
from axiomtradeapi import AxiomTradeClient
client = AxiomTradeClient()
test_wallet = "BJBgjyDZx5FSsyJf6bFKVXuJV7DZY9PCSMSi5d9tcEVh"
try:
balance = client.GetBalance(test_wallet)
print(f"โ
API Test Passed: {balance['sol']} SOL")
return True
except Exception as e:
print(f"โ API Test Failed: {e}")
return False
# Run test
import asyncio
if asyncio.run(test_installation()):
print("๐ AxiomTradeAPI-py is ready for use!")
๐ Community & Support
Join Our Growing Community
๐ Learn from Successful Traders โข ๐ ๏ธ Get Technical Support โข ๐ก Share Strategies โข ๐ Access Premium Content
Professional Services
Need a custom trading solution? Our team of expert developers can build:
- ๐ค Custom Trading Bots - Tailored to your strategy
- ๐ Portfolio Analytics - Advanced tracking and reporting
- ๐ Multi-Exchange Integration - Cross-platform trading
- ๐ก๏ธ Enterprise Security - Production-grade deployment
๐ Performance Benchmarks
Our SDK is optimized for professional trading applications:
| Metric | Performance | Industry Standard |
|---|---|---|
| Balance Query Speed | < 50ms | < 200ms |
| WebSocket Latency | < 10ms | < 50ms |
| Batch Operations | 1000+ wallets/request | 100 wallets/request |
| Memory Usage | < 30MB | < 100MB |
| Uptime | 99.9%+ | 99.5%+ |
๐ง Configuration Options
Environment Variables
# Authentication
export AXIOM_AUTH_TOKEN="your-auth-token"
export AXIOM_REFRESH_TOKEN="your-refresh-token"
# API Configuration
export AXIOM_API_TIMEOUT=30
export AXIOM_MAX_RETRIES=3
export AXIOM_LOG_LEVEL=INFO
# WebSocket Settings
export AXIOM_WS_RECONNECT_DELAY=5
export AXIOM_WS_MAX_RECONNECTS=10
Client Configuration
client = AxiomTradeClient(
auth_token="...",
refresh_token="...",
timeout=30,
max_retries=3,
log_level=logging.INFO,
rate_limit={"requests": 100, "window": 60} # 100 requests per minute
)
๐จ Important Disclaimers
โ ๏ธ Trading Risk Warning: Cryptocurrency trading involves substantial risk of loss. Never invest more than you can afford to lose.
๐ Security Notice: Always secure your API keys and never commit them to version control.
๐ No Financial Advice: This software is for educational and development purposes. We provide tools, not trading advice.
๐ License & Legal
This project is licensed under the MIT License - see the LICENSE file for details.
- โ Commercial Use Allowed
- โ Modification Allowed
- โ Distribution Allowed
- โ Private Use Allowed
๐ Acknowledgments
Special thanks to:
- The Solana Foundation for the robust blockchain infrastructure
- Axiom Trade for providing excellent API services
- Our community of developers and traders for continuous feedback
- All contributors who help improve this library
Built with โค๏ธ by the ChipaDevTeam
Website โข Documentation โข Discord โข Professional Services
โญ Star this repository if you find it useful!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file axiomtradeapi-1.1.0.tar.gz.
File metadata
- Download URL: axiomtradeapi-1.1.0.tar.gz
- Upload date:
- Size: 384.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f789a09ff005404d35187210547fb69a3d6fce81fc3e97ce9b4ec2e9e089c694
|
|
| MD5 |
eb68e19f47e5cec802ac11ce3a134ae5
|
|
| BLAKE2b-256 |
4136c9eb0df513d30c90b27803667f05bc893a156dac2f9cbb725ea49a6c46e2
|
File details
Details for the file axiomtradeapi-1.1.0-py3-none-any.whl.
File metadata
- Download URL: axiomtradeapi-1.1.0-py3-none-any.whl
- Upload date:
- Size: 42.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
430a15dd960ee97fdb34ca73a422afbce32841d0fb46a581e22f1bcc9bbf6807
|
|
| MD5 |
aecf7b296c62bdeff0a97a7e5c9b53c3
|
|
| BLAKE2b-256 |
5c0886306bd6005f4edc9e0c761b567036d48a2ef51fa803c3f5bbae966ada4a
|