Skip to main content
POST
/
aiagent
/
charge-fee
/
kalshi
/
{kalshiOrderId}
Charge Kalshi Fee
curl --request POST \
  --url https://pm-t1.bxingupdate.com/bvapi/aiagent/charge-fee/kalshi/{kalshiOrderId} \
  --header 'Authorization: Bearer <token>'
{
  "transactionId": "<string>",
  "feeAmount": 123,
  "status": "PENDING"
}

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 1% platform trading fee for a Kalshi order via Fireblocks USDC transfer on Solana.

Overview

After a successful Kalshi trade submission (kalshi_submit), the platform charges a 1% fee on the order amount. Fees are denominated in native USDC (SPL Token) on Solana mainnet. Unlike Polymarket, Kalshi fees are NOT collected automatically. The agent must call this endpoint after every successful kalshi_submit().

Fee Calculation

fee = orderAmount × 0.01
Example: A 10USDCbuyorderfee=10 USDC buy order → fee = **0.10 USDC**

Platform Fee Address (Solana)

CHMkL5utJWFFHSkHX6pwWcb8VXj5jAz5fAqqMGAyEXcX

Prerequisites

  1. Agent registered and Kalshi order submitted via POST /kalshi/submit
  2. Solana wallet holds sufficient USDC balance (order amount + 1% fee)
  3. USDC token approval granted to the platform vault address
  4. SOL for gas — minimal SOL needed for Solana transaction fees

Path Parameters

ParameterTypeRequiredDescription
kalshiOrderIdstringYesKalshi order transaction signature (from kalshi_submit response txSignature)

Response

transactionId
string
Fireblocks transaction ID for the USDC transfer
feeAmount
number
Fee amount charged in USDC (6 decimals)
status
string
Transaction status — typically PENDING, confirmed by Fireblocks polling

Examples

curl -X POST "https://pm-t1.bxingupdate.com/bvapi/aiagent/charge-fee/kalshi/5rHnS2kT9abc123..." \
  -H "Authorization: Bearer YOUR_API_KEY"

Error Responses

StatusCodeDescription
400ORDER_NOT_FOUNDKalshi order with given txSignature not found
400SOL_ADDRESS_MISSINGUser’s Solana address not available on the order
400INVALID_AMOUNTNo filled or order amount available to calculate fee
400INSUFFICIENT_BALANCEWallet USDC balance is insufficient for fee
500FIREBLOCKS_ERRORFireblocks SDK call failed

Important Notes

  • Kalshi fees are NOT automatic — the agent must call this endpoint after every successful trade
  • If charge_kalshi_fee() fails, the order itself is NOT affected (already submitted on-chain)
  • The fee amount is calculated from the order’s filledAmount (if available) or orderAmount
  • Agent commission (10% of fee) is calculated and tracked automatically
  • Use get_fee_status(txSignature, venue="kalshi") to verify fee was collected

Authorizations

Authorization
string
header
default:YOUR_API_KEY
required

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

Path Parameters

kalshiOrderId
string
required

Kalshi order transaction signature (txSignature from kalshi_submit response)

Response

Fee charge initiated

transactionId
string

Fireblocks transaction ID

feeAmount
number

Fee amount in USDC (6 decimals)

status
enum<string>

Transaction status

Available options:
PENDING,
COMPLETED,
FAILED