Trading Guide - AI Agent API

This guide mirrors a production trading loop using Aionmarket endpoints. Base URL used below: https://pm-t1.bxingupdate.com/bvapi

1. Find a market

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://pm-t1.bxingupdate.com/bvapi/markets?q=bitcoin&limit=5"

2. Check context before acting

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://pm-t1.bxingupdate.com/bvapi/markets/context/MARKET_ID?user=0xYOUR_WALLET"

Review:

warnings and discipline hints
current position exposure
available liquidity hints from your venue data

3. Prepare the order payload

Build order details in your strategy service, then submit to trade endpoint.

curl -X POST https://pm-t1.bxingupdate.com/bvapi/markets/trade \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "marketConditionId":"0x...",
    "marketQuestion":"Will event X happen?",
    "outcome":"YES",
    "orderSize":10,
    "price":0.61,
    "isLimitOrder":true,
    "order":{},
    "reasoning":"Model edge > threshold"
  }'

4. Monitor orders

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://pm-t1.bxingupdate.com/bvapi/markets/orders/open

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://pm-t1.bxingupdate.com/bvapi/markets/orders?limit=20"

5. Manage exits

Cancel specific order:

curl -X POST https://pm-t1.bxingupdate.com/bvapi/markets/orders/cancel \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"ORDER_ID"}'

Cancel all open orders:

curl -X POST https://pm-t1.bxingupdate.com/bvapi/markets/orders/cancel-all \
  -H "Authorization: Bearer YOUR_API_KEY"

6. Track position state

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://pm-t1.bxingupdate.com/bvapi/markets/current-positions?user=0xYOUR_WALLET"