Skip to main content
GET
/
agents
/
trades
Get Trades
curl --request GET \
  --url https://www.aionmarket.com/bvapi/agents/trades \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "message": "success",
  "data": {
    "total": 120,
    "limit": 50,
    "offset": 0,
    "venue": "all",
    "trades": [
      {
        "createdAt": "1713000000000",
        "marketConditionId": "0xabc123...",
        "marketConditionName": "Will BTC exceed $100k by June?",
        "skillCode": "weather-skill-v1",
        "skillSlug": "weather-arb",
        "sourceTag": "sdk",
        "reasoning": "Weather data indicates above-average temperature",
        "platform": "polymarket",
        "actionType": "BUY",
        "direction": "YES",
        "orderSize": "10",
        "amount": "5.00",
        "walletAddress": "0xabc..."
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.aionmarket.com/llms.txt

Use this file to discover all available pages before exploring further.

Get trade history for the authenticated agent.

​
Overview

Returns trade records from the agent’s strategy log. Use the venue parameter to filter by trading venue.
  • venue=all (default): merged trades across Polymarket + Kalshi, sorted by created_at desc
  • venue=polymarket: trades filtered to Polymarket only
  • venue=kalshi: trades filtered to Kalshi only
Each trade row includes a platform field identifying which venue it came from.
Cross-venue by default. venue defaults to all, returning merged trades sorted by created_at desc. Each row is tagged with a platform field. Pass ?venue=polymarket or ?venue=kalshi to filter to a single venue.

​
Example

curl -X GET "https://www.aionmarket.com/bvapi/agents/trades?venue=all&limit=50&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 120,
    "limit": 50,
    "offset": 0,
    "venue": "all",
    "trades": [
      {
        "createdAt": "1713000000000",
        "marketConditionId": "0xabc123...",
        "marketConditionName": "Will BTC exceed $100k by June?",
        "skillCode": "weather-skill-v1",
        "skillSlug": "weather-arb",
        "sourceTag": "sdk",
        "reasoning": "Weather data indicates above-average temperature",
        "platform": "polymarket",
        "actionType": "BUY",
        "direction": "YES",
        "orderSize": "10",
        "amount": "5.00",
        "walletAddress": "0xabc..."
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
venue
enum<string> | null
default:all

Venue filter: 'all' (default — polymarket + kalshi merged), 'polymarket', or 'kalshi'

Available options:
all,
polymarket,
kalshi
​
limit
integer
default:50

Max trades to return

Required range: 1 <= x <= 200
​
offset
integer
default:0

Offset for pagination

Required range: x >= 0

Response

Successful response

​
code
integer
Example:

200

​
message
string
Example:

"success"

​
data
object