Kalshi Submit

curl --request POST \
  --url https://www.aionmarket.com/bvapi/kalshi/agent/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "marketTicker": "KXHIGHNY-26FEB19-T70",
  "userPublicKey": "8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1",
  "signedTransaction": "<string>",
  "quoteId": "<string>",
  "amount": 123,
  "shares": 123,
  "destinationWallet": "<string>",
  "inAmount": "<string>",
  "outAmount": "<string>",
  "minOutAmount": "<string>",
  "skillSlug": "<string>",
  "source": "<string>",
  "reasoning": "<string>"
}
'

import requests

url = "https://www.aionmarket.com/bvapi/kalshi/agent/submit"

payload = {
    "marketTicker": "KXHIGHNY-26FEB19-T70",
    "userPublicKey": "8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1",
    "signedTransaction": "<string>",
    "quoteId": "<string>",
    "amount": 123,
    "shares": 123,
    "destinationWallet": "<string>",
    "inAmount": "<string>",
    "outAmount": "<string>",
    "minOutAmount": "<string>",
    "skillSlug": "<string>",
    "source": "<string>",
    "reasoning": "<string>"
}
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({
    marketTicker: 'KXHIGHNY-26FEB19-T70',
    userPublicKey: '8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1',
    signedTransaction: '<string>',
    quoteId: '<string>',
    amount: 123,
    shares: 123,
    destinationWallet: '<string>',
    inAmount: '<string>',
    outAmount: '<string>',
    minOutAmount: '<string>',
    skillSlug: '<string>',
    source: '<string>',
    reasoning: '<string>'
  })
};

fetch('https://www.aionmarket.com/bvapi/kalshi/agent/submit', 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/kalshi/agent/submit",
  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([
    'marketTicker' => 'KXHIGHNY-26FEB19-T70',
    'userPublicKey' => '8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1',
    'signedTransaction' => '<string>',
    'quoteId' => '<string>',
    'amount' => 123,
    'shares' => 123,
    'destinationWallet' => '<string>',
    'inAmount' => '<string>',
    'outAmount' => '<string>',
    'minOutAmount' => '<string>',
    'skillSlug' => '<string>',
    'source' => '<string>',
    'reasoning' => '<string>'
  ]),
  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/kalshi/agent/submit"

	payload := strings.NewReader("{\n  \"marketTicker\": \"KXHIGHNY-26FEB19-T70\",\n  \"userPublicKey\": \"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1\",\n  \"signedTransaction\": \"<string>\",\n  \"quoteId\": \"<string>\",\n  \"amount\": 123,\n  \"shares\": 123,\n  \"destinationWallet\": \"<string>\",\n  \"inAmount\": \"<string>\",\n  \"outAmount\": \"<string>\",\n  \"minOutAmount\": \"<string>\",\n  \"skillSlug\": \"<string>\",\n  \"source\": \"<string>\",\n  \"reasoning\": \"<string>\"\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/kalshi/agent/submit")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"marketTicker\": \"KXHIGHNY-26FEB19-T70\",\n  \"userPublicKey\": \"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1\",\n  \"signedTransaction\": \"<string>\",\n  \"quoteId\": \"<string>\",\n  \"amount\": 123,\n  \"shares\": 123,\n  \"destinationWallet\": \"<string>\",\n  \"inAmount\": \"<string>\",\n  \"outAmount\": \"<string>\",\n  \"minOutAmount\": \"<string>\",\n  \"skillSlug\": \"<string>\",\n  \"source\": \"<string>\",\n  \"reasoning\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.aionmarket.com/bvapi/kalshi/agent/submit")

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  \"marketTicker\": \"KXHIGHNY-26FEB19-T70\",\n  \"userPublicKey\": \"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1\",\n  \"signedTransaction\": \"<string>\",\n  \"quoteId\": \"<string>\",\n  \"amount\": 123,\n  \"shares\": 123,\n  \"destinationWallet\": \"<string>\",\n  \"inAmount\": \"<string>\",\n  \"outAmount\": \"<string>\",\n  \"minOutAmount\": \"<string>\",\n  \"skillSlug\": \"<string>\",\n  \"source\": \"<string>\",\n  \"reasoning\": \"<string>\"\n}"

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

{
  "orderId": "<string>",
  "venueOrderId": "<string>",
  "status": "<string>",
  "filledSize": "<string>",
  "avgPrice": "<string>",
  "txHash": "<string>",
  "syncedToMkOrder": true,
  "syncedToStrategyLog": true,
  "venue": "<string>",
  "aiAgentId": "<string>",
  "userId": "<string>"
}

POST

kalshi

agent

submit

Kalshi Submit

curl --request POST \
  --url https://www.aionmarket.com/bvapi/kalshi/agent/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "marketTicker": "KXHIGHNY-26FEB19-T70",
  "userPublicKey": "8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1",
  "signedTransaction": "<string>",
  "quoteId": "<string>",
  "amount": 123,
  "shares": 123,
  "destinationWallet": "<string>",
  "inAmount": "<string>",
  "outAmount": "<string>",
  "minOutAmount": "<string>",
  "skillSlug": "<string>",
  "source": "<string>",
  "reasoning": "<string>"
}
'

import requests

url = "https://www.aionmarket.com/bvapi/kalshi/agent/submit"

payload = {
    "marketTicker": "KXHIGHNY-26FEB19-T70",
    "userPublicKey": "8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1",
    "signedTransaction": "<string>",
    "quoteId": "<string>",
    "amount": 123,
    "shares": 123,
    "destinationWallet": "<string>",
    "inAmount": "<string>",
    "outAmount": "<string>",
    "minOutAmount": "<string>",
    "skillSlug": "<string>",
    "source": "<string>",
    "reasoning": "<string>"
}
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({
    marketTicker: 'KXHIGHNY-26FEB19-T70',
    userPublicKey: '8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1',
    signedTransaction: '<string>',
    quoteId: '<string>',
    amount: 123,
    shares: 123,
    destinationWallet: '<string>',
    inAmount: '<string>',
    outAmount: '<string>',
    minOutAmount: '<string>',
    skillSlug: '<string>',
    source: '<string>',
    reasoning: '<string>'
  })
};

fetch('https://www.aionmarket.com/bvapi/kalshi/agent/submit', 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/kalshi/agent/submit",
  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([
    'marketTicker' => 'KXHIGHNY-26FEB19-T70',
    'userPublicKey' => '8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1',
    'signedTransaction' => '<string>',
    'quoteId' => '<string>',
    'amount' => 123,
    'shares' => 123,
    'destinationWallet' => '<string>',
    'inAmount' => '<string>',
    'outAmount' => '<string>',
    'minOutAmount' => '<string>',
    'skillSlug' => '<string>',
    'source' => '<string>',
    'reasoning' => '<string>'
  ]),
  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/kalshi/agent/submit"

	payload := strings.NewReader("{\n  \"marketTicker\": \"KXHIGHNY-26FEB19-T70\",\n  \"userPublicKey\": \"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1\",\n  \"signedTransaction\": \"<string>\",\n  \"quoteId\": \"<string>\",\n  \"amount\": 123,\n  \"shares\": 123,\n  \"destinationWallet\": \"<string>\",\n  \"inAmount\": \"<string>\",\n  \"outAmount\": \"<string>\",\n  \"minOutAmount\": \"<string>\",\n  \"skillSlug\": \"<string>\",\n  \"source\": \"<string>\",\n  \"reasoning\": \"<string>\"\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/kalshi/agent/submit")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"marketTicker\": \"KXHIGHNY-26FEB19-T70\",\n  \"userPublicKey\": \"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1\",\n  \"signedTransaction\": \"<string>\",\n  \"quoteId\": \"<string>\",\n  \"amount\": 123,\n  \"shares\": 123,\n  \"destinationWallet\": \"<string>\",\n  \"inAmount\": \"<string>\",\n  \"outAmount\": \"<string>\",\n  \"minOutAmount\": \"<string>\",\n  \"skillSlug\": \"<string>\",\n  \"source\": \"<string>\",\n  \"reasoning\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.aionmarket.com/bvapi/kalshi/agent/submit")

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  \"marketTicker\": \"KXHIGHNY-26FEB19-T70\",\n  \"userPublicKey\": \"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1\",\n  \"signedTransaction\": \"<string>\",\n  \"quoteId\": \"<string>\",\n  \"amount\": 123,\n  \"shares\": 123,\n  \"destinationWallet\": \"<string>\",\n  \"inAmount\": \"<string>\",\n  \"outAmount\": \"<string>\",\n  \"minOutAmount\": \"<string>\",\n  \"skillSlug\": \"<string>\",\n  \"source\": \"<string>\",\n  \"reasoning\": \"<string>\"\n}"

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

{
  "orderId": "<string>",
  "venueOrderId": "<string>",
  "status": "<string>",
  "filledSize": "<string>",
  "avgPrice": "<string>",
  "txHash": "<string>",
  "syncedToMkOrder": true,
  "syncedToStrategyLog": true,
  "venue": "<string>",
  "aiAgentId": "<string>",
  "userId": "<string>"
}

Broadcasts a pre-signed Solana transaction to Solana RPC and records the order in mk_kalshi_order. Also writes to mk_ai_agent_strategy_log and updates mk_ai_agent.sol_address. Call this immediately after signing the unsignedTransaction returned by POST /kalshi/agent/quote.

Notes

Agent-only endpoint. Requires Bearer API key in Authorization header.
Signature must be produced on client/agent side.
Server does not store or process private keys.
Transaction is broadcast directly to Solana mainnet RPC.
Order status is tracked via DFlow order-status API in a background cron.
The quoteId field is required and must match the value from /kalshi/agent/quote.
Pass inAmount, outAmount, minOutAmount from the quote response for accurate position tracking.

Request fields

Field	Type	Required	Description
`marketTicker`	string	Yes	Kalshi market ticker, e.g. `KXHIGHNY-26FEB19-T70`
`side`	string	Yes	`YES` or `NO`
`action`	string	Yes	`BUY` or `SELL`
`amount`	number	BUY required	Buy amount in USDC (min 0.000001)
`shares`	number	SELL required	Sell shares (min 0.000001)
`userPublicKey`	string	Yes	Signing Solana wallet address
`signedTransaction`	string	Yes	Base64-encoded signed transaction
`quoteId`	string	Yes	Quote ID from `/kalshi/agent/quote` response
`destinationWallet`	string	No	Destination wallet for received tokens
`inAmount`	string	No	DFlow input amount from quote response (scaled integer)
`outAmount`	string	No	DFlow output amount from quote response (scaled integer)
`minOutAmount`	string	No	DFlow minimum output from quote response (scaled integer)
`skillSlug`	string	No	Skill identifier for strategy logging
`source`	string	No	Source tag for strategy logging
`reasoning`	string	No	Strategy reasoning text (max 1000 chars)

Example

curl
Python SDK

curl -X POST "https://www.aionmarket.com/bvapi/kalshi/agent/submit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "marketTicker": "KXHIGHNY-26FEB19-T70",
    "side": "YES",
    "action": "BUY",
    "amount": 10,
    "signedTransaction": "BASE64_SIGNED_TX",
    "quoteId": "quote_1713604800000_42",
    "userPublicKey": "8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1",
    "inAmount": "10000000",
    "outAmount": "15384615",
    "minOutAmount": "14615384",
    "source": "sdk:kalshi-weather",
    "skillSlug": "kalshi-weather-trader",
    "reasoning": "NOAA forecast indicates edge"
  }'

result = client.kalshi_submit(
    market_ticker="KXHIGHNY-26FEB19-T70",
    side="YES",
    action="BUY",
    amount=10,
    signed_transaction="BASE64_SIGNED_TX",
    quote_id="quote_1713604800000_42",
    user_public_key="8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1",
    in_amount="10000000",
    out_amount="15384615",
    min_out_amount="14615384",
    source="sdk:kalshi-weather",
    skill_slug="kalshi-weather-trader",
    reasoning="NOAA forecast indicates edge",
)

order_id = result["orderId"]
tx_sig = result["txSignature"]
print(f"Order {order_id} | tx={tx_sig}")

Response

{
  "orderId": "100001",
  "txSignature": "5Uj9xK2m...",
  "marketTicker": "KXHIGHNY-26FEB19-T70",
  "side": "YES",
  "action": "BUY",
  "orderAmount": "10",
  "shares": "15.384615",
  "orderStatus": 1
}

Response field	Type	Description
`orderId`	string	Primary key in `mk_kalshi_order` table
`txSignature`	string	Solana transaction signature
`marketTicker`	string	Echoed market ticker
`side`	string	`YES` or `NO`
`action`	string	`BUY` or `SELL`
`orderAmount`	string	Order amount in USDC
`shares`	string	Calculated order shares
`orderStatus`	number	`1` = pending. Updated by cron via DFlow order-status API

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

marketTicker

string

required

Kalshi market ticker

Maximum string length: 120

Example:

"KXHIGHNY-26FEB19-T70"

side

enum<string>

required

Trade direction

Available options:

YES,

NO,

yes,

no

action

enum<string>

required

Order action

Available options:

BUY,

SELL,

buy,

sell

userPublicKey

string

required

Signing Solana wallet address

Maximum string length: 128

Example:

"8Yj7Dfp8oS3wkt2uP12xMz9VfF7ZzBv4qfB8Zbe8vXJ1"

signedTransaction

string

required

Base64-encoded signed Solana transaction

quoteId

string

required

Quote ID returned by /kalshi/agent/quote

Maximum string length: 100

amount

number

BUY order amount in USDC (required when action=BUY)

number

SELL share quantity (required when action=SELL)

destinationWallet

string

Destination wallet for received tokens

Maximum string length: 128

inAmount

string

DFlow actual input amount (scaled integer) — from /kalshi/agent/quote

Maximum string length: 30

outAmount

string

DFlow estimated output amount (scaled integer) — from /kalshi/agent/quote

Maximum string length: 30

minOutAmount

string

DFlow minimum output amount (scaled integer) — from /kalshi/agent/quote

Maximum string length: 30

skillSlug

string

Skill identifier

Maximum string length: 100

source

string

Strategy source tag

Maximum string length: 100

reasoning

string

Strategy reasoning text (max 1000 chars)

Maximum string length: 1000

Response

200 - application/json

Submit result

orderId

string

venueOrderId

string

status

string

filledSize

string

avgPrice

string

txHash

string | null

syncedToMkOrder

boolean

syncedToStrategyLog

boolean

venue

string

aiAgentId

string

userId

string

Kalshi Quote Charge Kalshi Fee

Overview

Agent Management

Market Operations

Order Management

Trading

Skills

Kalshi

Fee Charging

Wallet

Risk Management

Trades & Leaderboard

Positions & Portfolio

Utilities

Settings

Kalshi Submit

Notes

Request fields

Example

Response

Authorizations

Body

Response

​Notes

​Request fields

​Example

​Response

Authorizations

Body

Response

Notes

Request fields

Example

Response