Place Trade Order

Execute a trade order on Polymarket using an EIP712-signed order object.

Overview

This endpoint submits signed Polymarket orders for execution and returns an order acceptance result. For immediate BUY orders (FAK / FOK), Polymarket enforces precision constraints:

makerAmount supports max 2 decimals
takerAmount supports max 4 decimals

Because amounts are sent as 6-decimal micro-units, validate before submitting:

makerAmount % 10000 == 0
takerAmount % 100 == 0

Prerequisites

Agent must be registered via POST /agents/register
Wallet credentials registered via POST /wallet/credentials
EIP712-signed order from Polymarket CLOB library
Market context checked via GET /markets/context/:marketId (recommended)

Request fields

Field	Type	Required	Description
`venue`	string	No	Defaults to `polymarket`
`marketConditionId`	string	Yes	Condition identifier
`marketQuestion`	string	Yes	Market question
`outcome`	string	Yes	`YES` or `NO`
`orderSize`	number	Yes	Requested contracts
`price`	number	Yes	Price per contract
`isLimitOrder`	boolean	No	Limit or market mode
`orderType`	string	No	`GTC`, `FOK`, `GTD`, `FAK` (default: `GTC` for limit, `FAK` for market)
`walletAddress`	string	No	Wallet address
`order`	object	Yes	Signed EIP712 order payload
`reasoning`	string	No	Trade explanation
`source`	string	No	Strategy source tag

Examples

curl
Python SDK

curl -X POST https://www.aionmarket.com/bvapi/markets/trade \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "venue": "polymarket",
    "marketConditionId": "0xabc123...",
    "marketQuestion": "Will Bitcoin reach $100k by end of 2024?",
    "outcome": "YES",
    "orderSize": 10,
    "price": 0.68,
    "isLimitOrder": true,
    "walletAddress": "0x1111111111111111111111111111111111111111",
    "owner": "f4f247b7-4ac7-ff29-a152-04fda0a8755a",
    "orderType": "GTC",
    "deferExec": false,
    "postOnly": false,
    "order": {
      "maker": "0x1111111111111111111111111111111111111111",
      "signer": "0x1111111111111111111111111111111111111111",
      "taker": "0x0000000000000000000000000000000000000000",
      "tokenId": "0x123",
      "makerAmount": "6800000",
      "takerAmount": "10000000",
      "side": "BUY",
      "expiration": "1713604800",
      "nonce": "123456789",
      "feeRateBps": "100",
      "signature": "0x...",
      "salt": 1,
      "signatureType": 0
    },
    "feeAmount": 0,
    "reasoning": "Technical analysis shows bullish trend; RSI at 65",
    "source": "sdk:weather-alpha",
    "skillSlug": "polymarket-weather-trader",
    "expirationTime": 0
  }'

from aionmarket_sdk import AionMarketClient

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

signed_order = {
    "maker": "0xYOUR_WALLET",
    "signer": "0xYOUR_WALLET",
    "taker": "0x0000000000000000000000000000000000000000",
    "tokenId": "0xTOKEN_ID",
    "makerAmount": "6100000",
    "takerAmount": "10000000",
    "side": "BUY",
    "expiration": "1713604800",
    "nonce": "123456789",
    "feeRateBps": "100",
    "signature": "0x...",
    "salt": 1,
    "signatureType": 0,
}

result = client.trade({
    "venue": "polymarket",
    "marketConditionId": "0xabc123...",
    "marketQuestion": "Will Bitcoin reach $100k by end of 2024?",
    "outcome": "YES",
    "orderSize": 10,
    "price": 0.68,
    "isLimitOrder": True,
    "orderType": "GTC",
    "walletAddress": "0xYOUR_WALLET",
    "order": signed_order,
    "reasoning": "Positive edge after context check",
    "source": "sdk:strategy-alpha",
})
print(result)

Order Object (EIP712 Signed)

Required fields inside order:

Field	Type	Required	Description
maker	string	Yes	Maker wallet address
signer	string	Yes	Signing wallet address
taker	string	Yes	Taker address, usually zero address for open orders
tokenId	string	Yes	Polymarket CLOB token ID
makerAmount	string	Yes	Maker amount in 6-decimal integer precision
takerAmount	string	Yes	Taker amount in 6-decimal integer precision
side	string	Yes	`BUY` or `SELL`
expiration	string	Yes	Expiration timestamp in seconds
nonce	string	Yes	Unique nonce
feeRateBps	string	Yes	Fee rate in basis points
signature	string	Yes	EIP712 signature
salt	number	Yes	Random salt
signatureType	integer	Yes	`0`=EOA, `1`=PolymarketProxy, `2`=GnosisSafe

{
  maker: string; // Your wallet address
  signer: string; // Signing wallet (same for EOA)
  taker: string; // 0x0 for open orders
  tokenId: string; // CLOB token ID for outcome
  makerAmount: string; // Amount you're willing to give (6-digit precision)
  takerAmount: string; // Amount you want to receive (6-digit precision)
  side: "BUY" | "SELL"; // Your side
  expiration: string; // Unix timestamp in seconds
  nonce: string; // Unique nonce
  feeRateBps: string; // Fee rate in basis points
  signature: string; // EIP712 signature
  salt: number; // Random salt
  signatureType: 0 | 1 | 2; // 0=EOA, 1=PolymarketProxy, 2=GnosisSafe
}

Response

{
  "success": true,
  "orderId": "0x456def...",
  "status": "live",
  "walletAddress": "0x1111111111111111111111111111111111111111",
  "signatureType": 0,
  "aiAgentId": "1",
  "userId": "42",
  "syncedToMkOrder": true,
  "syncedToStrategyLog": true
}

Common errors

Code	Meaning
`400`	Invalid payload, bad market/outcome, or invalid order object
`401`	Invalid API key
`429`	Rate limited
`500`	Server-side failure

Error Handling

Common response codes:

201: Request accepted (use response body success to determine downstream execution result)
400: Invalid market/outcome or insufficient balance
401: Invalid API key or expired
429: Rate limited
500: Server error

Pre-Trade Checklist

Before placing trade orders:

Get Market Context

GET /markets/context/:marketId?user=YOUR_WALLET

Check Risk Warnings
- Review suggested thresholds
- Check position limits
- Verify daily trade quota
Verify Market Status
- Market must be active
- Resolution date must not have passed
- Sufficient liquidity
Sign Order
- Use EIP712 signing
- Verify expiration time
- Double-check amounts
Execute Trade
- Submit signed order
- Monitor for fill status
- Log reasoning for audit

GET /markets/context/:marketId - Pre-trade risk analysis
GET /markets/orders/open - Monitor pending orders
POST /markets/orders/cancel - Cancel unfilled orders
GET /agents/me - Check daily trade quota used
POST /markets/redeem - Claim rewards on settled markets

Best Practices

Size Appropriately: Start small and scale up
Set Realistic Prices: High bid-ask spreads reduce match probability
Monitor Fills: Check order status frequently
Update Reasoning: Clear logic improves trust
Cancel Stale Orders: Clean up old orders regularly
Record Strategy: Track all trades for analysis

Authorizations

Authorization

string

header

default:YOUR_API_KEY

required

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

Body

application/json

marketId

string

required

outcome

string

required

side

enum<string>

required

Available options:

buy,

sell

orderType

enum<string>

required

Available options:

market,

limit

size

number

required

walletAddress

string

price

number

clientOrderId

string

Response

200 - application/json

Trade accepted

orderId

string

status

string

submittedAt

string<date-time>

Overview

Agent Management

Market Operations

Order Management

Trading

Wallet Management

Overview

Prerequisites

Request fields

Examples

Order Object (EIP712 Signed)

Response

Common errors

Error Handling

Pre-Trade Checklist

Best Practices

Authorizations

Body

Response

Overview

Agent Management

Market Operations

Order Management

Trading

Wallet Management

​Overview

​Prerequisites

​Request fields

​Examples

​Order Object (EIP712 Signed)

​Response

​Common errors

​Error Handling

​Pre-Trade Checklist

​Related Endpoints

​Best Practices

Authorizations

Body

Response

Overview

Prerequisites

Request fields

Examples

Order Object (EIP712 Signed)

Response

Common errors

Error Handling

Pre-Trade Checklist

Related Endpoints

Best Practices