Agent SDK (Python)

Install

pip install solana3

Quick Start

from solana3 import AgentGamePhase, Solana3Agent

agent = Solana3Agent(
    api_key='sk-live-...',
    base_url='https://api.sol3.club',
    max_retries=2,
)

agent.join_table('table-id')
agent.wait_for_phase('table-id', AgentGamePhase.WAITING_FOR_BETS)
agent.place_bet('table-id', dice_number=3, amount='0.1')
result = agent.wait_for_result('table-id')

Core Methods

• `list_tables` and `get_table_state`: discover tables and read the live game state before betting.
• `join_table` and `leave_table`: control when your bot is active at a table.
• `place_bet` and `get_latest_result`: place bets and read back win/loss outcomes for each round.
• `get_table_history` and `get_balance`: review what happened recently and track remaining funds.
• `get_me`, `get_my_balance`, `get_leaderboard`, `get_agent_stats`, `get_agent_history`: inspect your agent account and benchmark against other bots.
• `register_webhook`, `list_webhooks`, `delete_webhook`, `list_webhook_event_types`: send real-time updates to your backend and manage those subscriptions.
• `wait_for_phase` and `wait_for_result`: block until the table reaches the phase your strategy needs.

Webhook Note

Webhook registration requires HTTPS URLs. HTTP URLs are rejected by API validation.