Documentation/Authentication

Authentication Guide

Secure API access for WebSocket and advanced features

Beginner15 minutes

Authentication Overview

AxiomTradeAPI supports two authentication modes:

Public API

No authentication required

Balance queries
Basic market data
WebSocket features
Real-time monitoring

Authenticated API

Requires auth tokens

All public features
WebSocket real-time data
Token launch monitoring
Advanced trading features

Method 1: Browser Developer Tools (Recommended)

Step-by-Step Guide

1
Open Axiom Trade
Visit https://axiom.trade and sign in to your account
2
Open Developer Tools
Press F12 or right-click → "Inspect"
3
Navigate to Storage
Go to the Application tab (Chrome) or Storage tab (Firefox)
4
Find Cookies
Expand Cookies → https://axiom.trade
Look for these cookies:
- • auth-access-token
- • auth-refresh-token
5
Copy Token Values
Double-click the Value column and copy the entire token (starts with eyJ...)

Pro Tip

Tokens typically expire after 24 hours. The SDK automatically refreshes them using the refresh token, but you may need to update them occasionally.

Method 2: Network Tab Method

1
Open Developer Tools
Press F12 and go to the Network tab
2
Sign In
Log in to Axiom Trade while the Network tab is open
3
Find Login Request
Look for a request to /api/auth/login or similar
4
View Response
Click the request → Response tab to see the tokens in the JSON response

Configuring Your Bot

Create .env File

# .env file - KEEP THIS SECRET!
AXIOM_AUTH_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ...
AXIOM_REFRESH_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ...

# Add to .gitignore
# .env
# *.env
# .env.*

Python Configuration

import os
from dotenv import load_dotenv
from axiomtradeapi import AxiomTradeClient

# Load environment variables
load_dotenv()

# Initialize authenticated client
client = AxiomTradeClient(
    auth_token=os.getenv('AXIOM_AUTH_TOKEN'),
    refresh_token=os.getenv('AXIOM_REFRESH_TOKEN')
)

print("Authenticated client ready!")

Security Warning

• Never commit .env files to Git
• Never hardcode tokens directly in your code
• Rotate tokens regularly
• Use environment variables for production

Testing Authentication

test_auth.py

import os
import asyncio
from dotenv import load_dotenv
from axiomtradeapi import AxiomTradeClient

load_dotenv()

async def test_authentication():
    """Test if authentication is working"""
    
    # Initialize client
    client = AxiomTradeClient(
        auth_token=os.getenv('AXIOM_AUTH_TOKEN'),
        refresh_token=os.getenv('AXIOM_REFRESH_TOKEN')
    )
    
    print("Testing authentication...")
    
    # Test WebSocket connection (requires auth)
    async def handle_tokens(tokens):
        print(f"Authentication successful!")
        print(f"Received {len(tokens)} tokens")
        return True  # Stop after first batch
    
    try:
        await asyncio.wait_for(
            client.subscribe_new_tokens(callback=handle_tokens),
            timeout=10.0
        )
    except asyncio.TimeoutError:
        print("⏱Test completed (timeout)")
    except Exception as e:
        print(f"Authentication failed: {e}")

if __name__ == "__main__":
    asyncio.run(test_authentication())

Troubleshooting

"Authentication failed" Error

Solutions:

• Verify tokens are copied completely (including all characters)
• Check that tokens haven't expired (they typically last 24 hours)
• Ensure no extra spaces or line breaks in token values
• Re-obtain fresh tokens from Axiom Trade

".env file not found" Error

Solutions:

• Install python-dotenv: pip install python-dotenv
• Ensure .env file is in the same directory as your script
• Check file extension is exactly .env (not .env.txt)

Balance Queries

Monitor wallet balances and portfolios

WebSocket Guide

Real-time token monitoring