Charge Kalshi Fee

Charge platform trading fee for a Kalshi order. Reuses the same Fireblocks Raw signing + SPL transferChecked logic as /kalshi/charge-fee: the caller passes the fee amount and the user’s Solana wallet address; the backend signs and broadcasts an SPL transfer from the user’s USDC ATA to the platform fee ATA. Kalshi fees are NOT auto-charged — callers MUST invoke this after every successful trade.

POST /aiagent/charge-fee/kalshi/trade-fee

Charge Kalshi Fee

cURL

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

import requests

url = "https://www.aionmarket.com/bvapi/aiagent/charge-fee/kalshi/trade-fee"

payload = {
    "amount": "0.10",
    "fromAddress": "8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({amount: '0.10', fromAddress: '8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1'})
};

fetch('https://www.aionmarket.com/bvapi/aiagent/charge-fee/kalshi/trade-fee', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.aionmarket.com/bvapi/aiagent/charge-fee/kalshi/trade-fee",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => '0.10',
    'fromAddress' => '8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.aionmarket.com/bvapi/aiagent/charge-fee/kalshi/trade-fee"

	payload := strings.NewReader("{\n  \"amount\": \"0.10\",\n  \"fromAddress\": \"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.aionmarket.com/bvapi/aiagent/charge-fee/kalshi/trade-fee")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"0.10\",\n  \"fromAddress\": \"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.aionmarket.com/bvapi/aiagent/charge-fee/kalshi/trade-fee")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": \"0.10\",\n  \"fromAddress\": \"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1\"\n}"

response = http.request(request)
puts response.read_body

200

{
  "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

1. Agent registered and Kalshi order submitted via POST /kalshi/agent/submit
2. Solana wallet holds sufficient USDC (order amount + fee)
3. SPL token approval granted to the platform Fireblocks SOL address (the delegate)
4. SOL for gas — the platform Fireblocks SOL wallet pays gas, but the user’s USDC ATA must exist
5. 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

id · 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

curl -X POST "https://www.aionmarket.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"
  }'

Python SDK

from aion_sdk import AionMarketClient

client = AionMarketClient(
    api_key="YOUR_API_KEY",
    base_url="https://www.aionmarket.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

200

application/json

Fee broadcast result

id · string

Fireblocks transaction id (Raw signing job)

status · string

Broadcast status, typically BROADCASTED

txSignature · string

Solana transaction signature

fromAddress · string

toAddress · string

amount · string