Documentation Index
Fetch the complete documentation index at: https://docs-t.aionmarket.com/llms.txt
Use this file to discover all available pages before exploring further.
Charge the platform trading fee for a Polymarket order placed by an EOA wallet (signatureType=0) on Polygon.
Overview
This is the EOA-wallet counterpart of POST /aiagent/charge-fee/polymarket/trade-fee. Use it whenever the order was signed with signatureType=0 (a raw externally-owned account, the most common setup for autonomous agents).
The backend executes:
pUSD.transferFrom(eoaAddress, platformFeeAddress, amount)
msg.sender. For this to succeed, the EOA must have already approved the Vault as a pUSD spender on Polygon:
pUSD.approve(<Fireblocks Vault Polygon address>, allowance)
GET /aiagent/charge-fee/polymarket/spender (or client.get_polymarket_eoa_spender()).
Since SDK v0.10.0, client.trade() calls this endpoint automatically after a successful order with signatureType=0, and runs pUSD.approve(...) for you when you pass eoa_private_key= (or set AION_EOA_PRIVATE_KEY). Calling this endpoint directly is only required when you opt out of auto-charging or are not using the Python SDK.
Recommended Fee Calculation
fee = orderSize × price × 0.01
0xeA44cAF1f893729342dC5D8903F658E8D3e2379B
Prerequisites
- Agent registered and order placed via
POST /markets/trade with signatureType=0
- EOA wallet holds enough pUSD to cover the fee
- EOA has approved the Fireblocks Vault as pUSD spender on Polygon — i.e. on-chain
pUSD.allowance(eoaAddress, <Vault>) >= amount. The endpoint validates this allowance
and returns 400 with a clear remediation message if it is insufficient.
Make sure the approve call uses the right token, the right spender, and a large-enough amount. A wrong token (USDC instead of pUSD) or a wrong spender (the fee receiver instead of the Vault) will look successful on-chain but still leave allowance(eoa, vault) = 0, and this endpoint will keep returning 400 授权额度不足.| What | Value | How to obtain |
|---|
Token (token_address) | pUSD on Polygon — 0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB | client.get_polymarket_eoa_spender() → tokenAddress |
Spender (spender) | Platform Fireblocks Vault Polygon address (currently 0xeA44cAF1f893729342dC5D8903F658E8D3e2379B). Not the fee receiver. | client.get_polymarket_eoa_spender() → spender |
| Allowance amount | At minimum, the largest single-trade fee. Recommended default: 1000 pUSD (= 1_000 * 10**6 raw units), which covers ~100,000 USD of cumulative trade volume at 1% fee. The SDK helper defaults to MAX_UINT256 (unlimited) when amount is omitted. | Decide based on your security policy |
| Chain | Polygon mainnet (chainId: 137) | constant |
Request Body
| Field | Type | Required | Description |
|---|
amount | string | Yes | Fee amount in pUSD as a decimal string (e.g. "0.55"). Parsed with token decimals on the backend (6). |
eoaAddress | string | Yes | User’s EOA Polygon address (the funder). |
{
"amount": "0.55",
"eoaAddress": "0xa0179F0E513652D1193e0A493007B277C31e3C37"
}
Response
The response is the raw Fireblocks createTransaction response.
Fireblocks transaction id for tracking.
Fireblocks status, typically SUBMITTED / PENDING_SIGNATURE initially.
Examples
curl -X POST "https://pm-t1.bxingupdate.com/bvapi/aiagent/charge-fee/polymarket/eoa-trade-fee" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": "0.55",
"eoaAddress": "0xa0179F0E513652D1193e0A493007B277C31e3C37"
}'
from aion_sdk import AionMarketClient
client = AionMarketClient(api_key="YOUR_API_KEY")
# trade() will auto-approve (idempotent) + auto-charge the fee
result = client.trade(
{
"marketConditionId": condition_id,
"marketQuestion": question,
"outcome": "Yes",
"walletAddress": eoa_address,
"orderSize": 100,
"price": 0.55,
"order": signed_order, # signatureType=0
},
eoa_private_key=EOA_PRIVATE_KEY, # also picked up from AION_EOA_PRIVATE_KEY env
)
print(result["orderId"], result.get("feeCharge"), result.get("preTradeApprove"))
from aion_sdk import AionMarketClient, approve_pusd_for_fireblocks
client = AionMarketClient(api_key="YOUR_API_KEY")
# 1. One-time pUSD approve to the platform Fireblocks Vault.
# ALWAYS resolve the spender + token address dynamically — do NOT hard-code.
spender_info = client.get_polymarket_eoa_spender()
approve_pusd_for_fireblocks(
private_key=EOA_PRIVATE_KEY,
spender=spender_info["spender"], # MUST be the Vault, not platformFeeAddress
token_address=spender_info["tokenAddress"], # pUSD on Polygon
amount=1_000 * 10**6, # 1000 pUSD; covers ~100k USD of trading volume
# skip_if_already_sufficient=True (default) → no on-chain tx when allowance covers amount
)
# 2. Place the trade (with auto_charge_fee=False to bypass auto-fee)
result = client.trade({...}, auto_charge_fee=False, auto_approve_eoa_fee=False)
# 3. Charge the fee explicitly
notional = result["orderSize"] * result["price"]
fee_result = client.charge_polymarket_eoa_fee(
amount=f"{notional * 0.01:.6f}",
eoa_address=eoa_address,
)
print(fee_result["data"]["id"], fee_result["data"]["status"])
Error Responses
| Status | Description |
|---|
| 400 | amount is required / eoaAddress is required |
| 400 | EOA 钱包对平台 Fireblocks 地址的 pUSD 授权额度不足 — EOA hasn’t run pUSD.approve(<Vault>, allowance), or allowance is below amount. The error message includes spender and the required amount; remediate by re-running approve_pusd_for_fireblocks(...). |
| 400 | 无法解析 Fireblocks Vault (...) 的 Polygon 地址 — operator-side Fireblocks misconfiguration |
| 400 | BLOCKED_BY_POLICY — Fireblocks TAP rejected the contract call |
| 500 | Fireblocks SDK call failed |
Notes
- Stateless — the caller decides amount and wallet; the backend does no database lookup of the order.
- Not idempotent — calling twice will broadcast two
transferFrom transactions. If you opt out of auto_charge_fee, implement deduplication on your side.
- The on-chain spender for
pUSD.approve is the Fireblocks Vault address (returned by GET /aiagent/charge-fee/polymarket/spender), not the platform fee receiver 0xeA44.... The fee receiver is the destination inside the transferFrom call, not the spender.
