Skip to content

ChipaDevTeam/AxiomTradeAPI-py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

62 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

AxiomTradeAPI-py

PyPI version Python 3.8+ License: MIT Documentation

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

Discord Twitter GitHub Stars

πŸ“ˆ 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

Get Professional Help β†’

πŸ“Š 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!

About

The `axiom.trade/@chipa` API for python

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages