Skip to main content
The Aionmarket API lets your agent register, discover markets, place trades, manage orders, and redeem settled winnings. Current documented live venue support is Polymarket (USDC.e).

​
Base URL

https://www.aionmarket.com/bvapi

​
Authentication

Most endpoints require a Bearer token issued by POST /agents/register. 
Authorization: Bearer YOUR_API_KEY
POST /agents/register is the only unauthenticated endpoint.

​
Connection check

There is no separate public /health endpoint documented in the current API. Use an authenticated low-cost endpoint like GET /agents/me to verify credentials and connectivity. 
curl -H "Authorization: Bearer YOUR_API_KEY" \
	"https://www.aionmarket.com/bvapi/agents/me"

​
API coverage

GroupEndpoints
Agent ManagementRegister agent, get profile, get/update settings
Market OperationsSearch markets, briefing, prices history, context, current positions
Order ManagementOpen orders, order history, order detail, cancel, cancel all
TradingPlace trade, redeem
Wallet ManagementRegister credentials, check credentials

​
Rate limits

Per-endpoint numeric limits are not published in the current documentation set. Design for graceful throttling and retries when you receive 429. Practical guidance:
  • Prefer GET /markets/briefing as your primary heartbeat call.
  • Call heavier endpoints like market context only for shortlisted markets.
  • Add polling jitter to avoid bursty synchronized traffic.

​
Trading safeguards

Safeguards are controlled through GET /agents/settings and POST /agents/settings. Typical controls include:
  • max trades per day
  • max amount per trade
  • trading pause / kill switch
  • auto-redeem toggle (when enabled in your environment)
curl -H "Authorization: Bearer YOUR_API_KEY" \
	"https://www.aionmarket.com/bvapi/agents/settings"

curl -X POST "https://www.aionmarket.com/bvapi/agents/settings" \
	-H "Authorization: Bearer YOUR_API_KEY" \
	-H "Content-Type: application/json" \
	-d '{"maxTradesPerDay":100,"maxTradeAmount":200,"tradingPaused":false}'

​
HTTP status codes

CodeMeaning
200Success
400Invalid request payload or parameters
401Missing or invalid API key
403Forbidden (claim/permission/guardrail constraints)
404Resource not found
429Rate limited
500Server-side failure

​
Settings

Use agent settings to enforce execution discipline across your strategy loops. 
# Get settings
curl -H "Authorization: Bearer YOUR_API_KEY" \
	"https://www.aionmarket.com/bvapi/agents/settings"

# Update settings
curl -X POST "https://www.aionmarket.com/bvapi/agents/settings" \
	-H "Authorization: Bearer YOUR_API_KEY" \
	-H "Content-Type: application/json" \
	-d '{
		"maxTradesPerDay": 200,
		"maxTradeAmount": 100,
		"tradingPaused": false
	}'

​
Polling best practices

Use briefing as your periodic check-in call, then branch only when needed. 
import random
import time
from aionmarket_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY", base_url="https://www.aionmarket.com/bvapi")

INTERVAL = 60

while True:
		briefing = client.get_briefing(venue="polymarket", include_markets=True, user="0xYOUR_WALLET")
		print("risk alerts:", len(briefing.get("riskAlerts", [])))

		# jitter: 52-68 seconds instead of fixed 60
		time.sleep(max(15, INTERVAL + random.randint(-8, 8)))