Charge Kalshi Fee

curl --request POST \
  --url https://pm-t1.bxingupdate.com/bvapi/aiagent/charge-fee/kalshi/trade-fee \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "0.10",
  "fromAddress": "8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1"
}
'

{
  "id": "<string>",
  "status": "<string>",
  "txSignature": "<string>",
  "fromAddress": "<string>",
  "toAddress": "<string>",
  "amount": "<string>"
}

POST

aiagent

charge-fee

kalshi

trade-fee

Charge Kalshi Fee

curl --request POST \
  --url https://pm-t1.bxingupdate.com/bvapi/aiagent/charge-fee/kalshi/trade-fee \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "0.10",
  "fromAddress": "8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1"
}
'

{
  "id": "<string>",
  "status": "<string>",
  "txSignature": "<string>",
  "fromAddress": "<string>",
  "toAddress": "<string>",
  "amount": "<string>"
}

Charge the platform trading fee for a Kalshi order via Fireblocks Raw signing + SPL transferChecked on Solana.

Overview

After a successful Kalshi trade submission, the agent (or frontend) calls this endpoint with:

the fee amount (typically 1% of order amount)
the user’s fromAddress (Solana wallet, USDC ATA owner)

The backend reuses the exact same Fireblocks Raw signing + SPL transferChecked logic as POST /kalshi/charge-fee — the platform Fireblocks SOL key (already approved as the user’s SPL token delegate) signs an SPL transfer that moves USDC from the user’s USDC ATA to the platform fee ATA.

Recommended Fee Calculation

fee = orderAmount × 0.01

Example: A

10 USDC buy order → fee = **

0.10 USDC**

The endpoint does not recompute the fee from the database; the caller is the source of truth for amount.

Platform Fee Address (Solana)

CHMkL5utJWFFHSkHX6pwWcb8VXj5jAz5fAqqMGAyEXcX

Prerequisites

Agent registered and Kalshi order submitted via POST /kalshi/agent/submit
Solana wallet holds sufficient USDC (order amount + fee)
SPL token approval granted to the platform Fireblocks SOL address (the delegate)
SOL for gas — the platform Fireblocks SOL wallet pays gas, but the user’s USDC ATA must exist
Fireblocks TAP allows Raw signing for the SOL vault account

Request Body

Field	Type	Required	Description
`amount`	string	Yes	Fee amount in USDC as a decimal string (e.g. `"0.10"`).
`fromAddress`	string	Yes	User’s Solana wallet address (USDC ATA owner).

{
  "amount": "0.10",
  "fromAddress": "8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1"
}

Response

string

Fireblocks transaction id (Raw signing job).

status

string

Final broadcast state, typically BROADCASTED.

txSignature

string

Solana transaction signature (after broadcast).

fromAddress

string

User’s Solana wallet (echoed).

toAddress

string

Platform fee receiving wallet on Solana.

amount

string

Fee amount echoed back as a decimal string.

Examples

curl
Python SDK

curl -X POST "https://pm-t1.bxingupdate.com/bvapi/aiagent/charge-fee/kalshi/trade-fee" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "0.10",
    "fromAddress": "8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1"
  }'

from aion_sdk import AionMarketClient

client = AionMarketClient(
    api_key="YOUR_API_KEY",
    base_url="https://pm-t1.bxingupdate.com/bvapi",
)

# After a successful kalshi submit
submit_result = client.kalshi_submit(...)
fee_amount = f"{order_amount * 0.01:.6f}"

# REQUIRED: charge the platform fee
fee_result = client.charge_kalshi_fee(
    amount=fee_amount,
    from_address=sol_wallet_address,
)
print(fee_result["txSignature"], fee_result["status"])

Error Responses

Status	Description
400	`amount is required` / `fromAddress is required`
400	`平台 delegate 地址与用户钱包地址相同` — fromAddress equals the platform vault SOL address
400	`Solana 地址无效` — invalid pubkey
400	`Fireblocks 签名失败 ... BLOCKED_BY_POLICY` — Fireblocks TAP rejects Raw signing; configure a Raw Signing rule allowing the SOL vault
400	`Solana 广播失败` — RPC rejection (insufficient delegated allowance, no USDC balance, etc.)
500	Fireblocks SDK call failed

Important Notes

Kalshi fees are NOT auto-charged — the agent must call this endpoint after every successful trade.
This endpoint is stateless — the caller decides amount and wallet; the backend does no DB lookup. Callers must implement idempotency.
Underlying logic is identical to POST /kalshi/charge-fee.
If BLOCKED_BY_POLICY is returned, configure a Transaction Authorization Policy rule in the Fireblocks Console allowing Raw Signing for the SOL vault used by the platform.

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

amount

string

required

Fee amount in USDC as a decimal string (e.g. '0.10').

Example:

"0.10"

fromAddress

string

required

User's Solana wallet address (USDC ATA owner).

Example:

"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1"

Response

Fee broadcast result

string

Fireblocks transaction id (Raw signing job)

status

string

Broadcast status, typically BROADCASTED

txSignature

string

Solana transaction signature

fromAddress

string

toAddress

string

amount

string

Kalshi Submit Register Wallet Credentials

​Overview

​Recommended Fee Calculation

​Platform Fee Address (Solana)

​Prerequisites

​Request Body

​Response

​Examples

​Error Responses

​Important Notes

Authorizations

Body

Response

Overview

Recommended Fee Calculation

Platform Fee Address (Solana)

Prerequisites

Request Body

Response

Examples

Error Responses

Important Notes