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.
Query the fee charging status for an order on either Polymarket or Kalshi.
Overview
Check whether the platform trading fee has been successfully charged for a given order. Useful for:
- Confirming fee collection completed after triggering
charge_polymarket_fee() or charge_kalshi_fee()
- Debugging failed fee charges
- Monitoring fee collection in automated workflows
Path Parameters
| Parameter | Type | Required | Description |
|---|
orderHashId | string | Yes | Order identifier — Polymarket orderHashId or Kalshi txSignature |
Query Parameters
| Parameter | Type | Required | Description |
|---|
venue | string | Yes | Market venue: polymarket or kalshi |
Response
The order identifier passed in the request
Fee amount charged (null if not yet charged)
Fee status: pending | charged | failed | unknown
Error description if status is failed
Status Values
| Status | Description |
|---|
pending | Fee charge initiated but not yet confirmed |
charged | Fee successfully deducted from user wallet |
failed | Fee charge failed — check errorReason |
unknown | Order not found in the system |
Examples
# Check Polymarket fee status
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://pm-t1.bxingupdate.com/bvapi/aiagent/charge-fee/status/0xabc123?venue=polymarket"
# Check Kalshi fee status
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://pm-t1.bxingupdate.com/bvapi/aiagent/charge-fee/status/5rHnS2kT9abc?venue=kalshi"
from aion_sdk import AionMarketClient
client = AionMarketClient(
api_key="YOUR_API_KEY",
base_url="https://pm-t1.bxingupdate.com/bvapi",
)
# Polymarket fee status
status = client.get_fee_status("0xabc123def456", venue="polymarket")
print(f"Status: {status['status']}, Fee: {status['feeAmount']}")
# Kalshi fee status
status = client.get_fee_status("5rHnS2kT9abc123", venue="kalshi")
print(f"Status: {status['status']}")
if status["status"] == "failed":
print(f"Error: {status.get('errorReason')}")
Notes
- For Polymarket,
status=charged means handleStatus=1 in the order record
- For Kalshi, fee tracking depends on the Fireblocks transaction completion
- Polling interval recommendation: check every 10 seconds for up to 2 minutes
- If status remains
pending for > 5 minutes, investigate via Fireblocks console
Authorization
string
header
default:YOUR_API_KEY
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Order identifier (Polymarket orderHashId or Kalshi txSignature)
Available options:
polymarket,
kalshi
Fee amount (null if not charged)
Available options:
pending,
charged,
failed,
unknown
Error description if failed