Files
simstudioai--sim/apps/sim/tools/kalshi/amend_order.ts
T
wehub-resource-sync d25d482dc2
Publish CLI Package / publish-npm (push) Waiting to run
Publish Python SDK / publish-pypi (push) Waiting to run
Publish TypeScript SDK / publish-npm (push) Waiting to run
CI / Migrate Dev DB (push) Has been skipped
CI / Detect Version (push) Has been cancelled
CI / Migrate DB (push) Has been cancelled
CI / Build Dev ECR (./docker/app.Dockerfile, ECR_APP) (push) Has been cancelled
CI / Build Dev ECR (./docker/db.Dockerfile, ECR_MIGRATIONS) (push) Has been cancelled
CI / Build Dev ECR (./docker/pii.Dockerfile, ECR_PII) (push) Has been cancelled
CI / Build Dev ECR (./docker/realtime.Dockerfile, ECR_REALTIME) (push) Has been cancelled
CI / Deploy Trigger.dev (Dev) (push) Has been cancelled
CI / Build AMD64 (./docker/app.Dockerfile, ECR_APP, ghcr.io/simstudioai/simstudio) (push) Has been cancelled
CI / Build AMD64 (./docker/db.Dockerfile, ECR_MIGRATIONS, ghcr.io/simstudioai/migrations) (push) Has been cancelled
CI / Build AMD64 (./docker/pii.Dockerfile, ECR_PII, ghcr.io/simstudioai/pii) (push) Has been cancelled
CI / Build AMD64 (./docker/realtime.Dockerfile, ECR_REALTIME, ghcr.io/simstudioai/realtime) (push) Has been cancelled
CI / Build ARM64 (GHCR Only) (./docker/app.Dockerfile, ghcr.io/simstudioai/simstudio) (push) Has been cancelled
CI / Build ARM64 (GHCR Only) (./docker/db.Dockerfile, ghcr.io/simstudioai/migrations) (push) Has been cancelled
CI / Build ARM64 (GHCR Only) (./docker/pii.Dockerfile, ghcr.io/simstudioai/pii) (push) Has been cancelled
CI / Build ARM64 (GHCR Only) (./docker/realtime.Dockerfile, ghcr.io/simstudioai/realtime) (push) Has been cancelled
CI / Create GHCR Manifests (ghcr.io/simstudioai/migrations) (push) Has been cancelled
CI / Create GHCR Manifests (ghcr.io/simstudioai/pii) (push) Has been cancelled
CI / Create GHCR Manifests (ghcr.io/simstudioai/realtime) (push) Has been cancelled
CI / Create GHCR Manifests (ghcr.io/simstudioai/simstudio) (push) Has been cancelled
CI / Check Docs Changes (push) Has been cancelled
CI / Process Docs (push) Has been cancelled
CI / Create GitHub Release (push) Has been cancelled
CI / Test and Build (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:20:55 +08:00

458 lines
16 KiB
TypeScript

import type { KalshiAuthParams, KalshiOrder } from '@/tools/kalshi/types'
import { buildKalshiAuthHeaders, buildKalshiUrl, handleKalshiError } from '@/tools/kalshi/types'
import type { ToolConfig } from '@/tools/types'
export interface KalshiAmendOrderParams extends KalshiAuthParams {
orderId: string // Order ID to amend (required)
ticker: string // Market ticker (required)
side: string // 'yes' or 'no' (required)
action: string // 'buy' or 'sell' (required)
clientOrderId: string // Original client order ID (required)
updatedClientOrderId: string // New client order ID (required)
count?: string // Updated quantity
yesPrice?: string // Updated yes price in cents (1-99)
noPrice?: string // Updated no price in cents (1-99)
yesPriceDollars?: string // Updated yes price in dollars
noPriceDollars?: string // Updated no price in dollars
}
export interface KalshiAmendOrderResponse {
success: boolean
output: {
order: KalshiOrder
}
}
export const kalshiAmendOrderTool: ToolConfig<KalshiAmendOrderParams, KalshiAmendOrderResponse> = {
id: 'kalshi_amend_order',
name: 'Amend Order on Kalshi',
description: 'Modify the price or quantity of an existing order on Kalshi',
version: '1.0.0',
params: {
keyId: {
type: 'string',
required: true,
visibility: 'user-only',
description: 'Your Kalshi API Key ID',
},
privateKey: {
type: 'string',
required: true,
visibility: 'user-only',
description: 'Your RSA Private Key (PEM format)',
},
orderId: {
type: 'string',
required: true,
visibility: 'user-or-llm',
description: 'Order ID to amend (e.g., "abc123-def456-ghi789")',
},
ticker: {
type: 'string',
required: true,
visibility: 'user-or-llm',
description: 'Market ticker identifier (e.g., "KXBTC-24DEC31", "INX-25JAN03-T4485.99")',
},
side: {
type: 'string',
required: true,
visibility: 'user-or-llm',
description: 'Side of the order: "yes" or "no"',
},
action: {
type: 'string',
required: true,
visibility: 'user-or-llm',
description: 'Action type: "buy" or "sell"',
},
clientOrderId: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Original client-specified order ID',
},
updatedClientOrderId: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'New client-specified order ID after amendment',
},
count: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Updated quantity for the order (e.g., "10", "100")',
},
yesPrice: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Updated yes price in cents (1-99)',
},
noPrice: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Updated no price in cents (1-99)',
},
yesPriceDollars: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Updated yes price in dollars (e.g., "0.56")',
},
noPriceDollars: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Updated no price in dollars (e.g., "0.56")',
},
},
request: {
url: (params) => buildKalshiUrl(`/portfolio/orders/${params.orderId.trim()}/amend`),
method: 'POST',
headers: (params) => {
const path = `/trade-api/v2/portfolio/orders/${params.orderId.trim()}/amend`
return buildKalshiAuthHeaders(params.keyId, params.privateKey, 'POST', path)
},
body: (params) => {
const body: Record<string, any> = {
ticker: params.ticker,
side: params.side.toLowerCase(),
action: params.action.toLowerCase(),
client_order_id: params.clientOrderId,
updated_client_order_id: params.updatedClientOrderId,
}
if (params.count) body.count = Number.parseInt(params.count, 10)
if (params.yesPrice) body.yes_price = Number.parseInt(params.yesPrice, 10)
if (params.noPrice) body.no_price = Number.parseInt(params.noPrice, 10)
if (params.yesPriceDollars) body.yes_price_dollars = params.yesPriceDollars
if (params.noPriceDollars) body.no_price_dollars = params.noPriceDollars
return body
},
},
transformResponse: async (response: Response) => {
const data = await response.json()
if (!response.ok) {
handleKalshiError(data, response.status, 'amend_order')
}
return {
success: true,
output: {
order: data.order,
},
}
},
outputs: {
order: {
type: 'object',
description: 'The amended order object',
},
},
}
export interface KalshiAmendOrderV2Params extends KalshiAuthParams {
orderId: string // Order ID to amend (required)
ticker: string // Market ticker (required)
side: string // 'yes' or 'no' (required)
action: string // 'buy' or 'sell' (required)
clientOrderId?: string // Original client order ID (optional in V2)
updatedClientOrderId?: string // New client order ID (optional in V2)
count?: string // Updated quantity
yesPrice?: string // Updated yes price in cents (1-99)
noPrice?: string // Updated no price in cents (1-99)
yesPriceDollars?: string // Updated yes price in dollars
noPriceDollars?: string // Updated no price in dollars
countFp?: string // Count in fixed-point for fractional contracts
}
interface KalshiAmendOrderV2Order {
order_id: string
user_id: string | null
ticker: string
event_ticker: string
status: string
side: string
type: string
yes_price: number | null
no_price: number | null
action: string
count: number
remaining_count: number
created_time: string
expiration_time: string | null
order_group_id: string | null
client_order_id: string | null
place_count: number | null
decrease_count: number | null
queue_position: number | null
maker_fill_count: number | null
taker_fill_count: number | null
maker_fees: number | null
taker_fees: number | null
last_update_time: string | null
take_profit_order_id: string | null
stop_loss_order_id: string | null
amend_count: number | null
amend_taker_fill_count: number | null
}
export interface KalshiAmendOrderV2Response {
success: boolean
output: {
old_order: KalshiAmendOrderV2Order
order: KalshiAmendOrderV2Order
}
}
export const kalshiAmendOrderV2Tool: ToolConfig<
KalshiAmendOrderV2Params,
KalshiAmendOrderV2Response
> = {
id: 'kalshi_amend_order_v2',
name: 'Amend Order on Kalshi V2',
description:
'Modify the price or quantity of an existing order on Kalshi (V2 with full API response)',
version: '2.0.0',
params: {
keyId: {
type: 'string',
required: true,
visibility: 'user-only',
description: 'Your Kalshi API Key ID',
},
privateKey: {
type: 'string',
required: true,
visibility: 'user-only',
description: 'Your RSA Private Key (PEM format)',
},
orderId: {
type: 'string',
required: true,
visibility: 'user-or-llm',
description: 'Order ID to amend (e.g., "abc123-def456-ghi789")',
},
ticker: {
type: 'string',
required: true,
visibility: 'user-or-llm',
description: 'Market ticker identifier (e.g., "KXBTC-24DEC31", "INX-25JAN03-T4485.99")',
},
side: {
type: 'string',
required: true,
visibility: 'user-or-llm',
description: 'Side of the order: "yes" or "no"',
},
action: {
type: 'string',
required: true,
visibility: 'user-or-llm',
description: 'Action type: "buy" or "sell"',
},
clientOrderId: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Original client-specified order ID',
},
updatedClientOrderId: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'New client-specified order ID after amendment',
},
count: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Updated quantity for the order (e.g., "10", "100")',
},
yesPrice: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Updated yes price in cents (1-99)',
},
noPrice: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Updated no price in cents (1-99)',
},
yesPriceDollars: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Updated yes price in dollars (e.g., "0.56")',
},
noPriceDollars: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Updated no price in dollars (e.g., "0.56")',
},
countFp: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Count in fixed-point for fractional contracts',
},
},
request: {
url: (params) => buildKalshiUrl(`/portfolio/orders/${params.orderId.trim()}/amend`),
method: 'POST',
headers: (params) => {
const path = `/trade-api/v2/portfolio/orders/${params.orderId.trim()}/amend`
return buildKalshiAuthHeaders(params.keyId, params.privateKey, 'POST', path)
},
body: (params) => {
const body: Record<string, any> = {
ticker: params.ticker,
side: params.side.toLowerCase(),
action: params.action.toLowerCase(),
}
if (params.clientOrderId) body.client_order_id = params.clientOrderId
if (params.updatedClientOrderId) body.updated_client_order_id = params.updatedClientOrderId
if (params.count) body.count = Number.parseInt(params.count, 10)
if (params.yesPrice) body.yes_price = Number.parseInt(params.yesPrice, 10)
if (params.noPrice) body.no_price = Number.parseInt(params.noPrice, 10)
if (params.yesPriceDollars) body.yes_price_dollars = params.yesPriceDollars
if (params.noPriceDollars) body.no_price_dollars = params.noPriceDollars
if (params.countFp) body.count_fp = params.countFp
return body
},
},
transformResponse: async (response: Response) => {
const data = await response.json()
if (!response.ok) {
handleKalshiError(data, response.status, 'amend_order_v2')
}
const mapOrder = (order: any): KalshiAmendOrderV2Order => ({
order_id: order.order_id ?? null,
user_id: order.user_id ?? null,
ticker: order.ticker ?? null,
event_ticker: order.event_ticker ?? null,
status: order.status ?? null,
side: order.side ?? null,
type: order.type ?? null,
yes_price: order.yes_price ?? null,
no_price: order.no_price ?? null,
action: order.action ?? null,
count: order.count ?? null,
remaining_count: order.remaining_count ?? null,
created_time: order.created_time ?? null,
expiration_time: order.expiration_time ?? null,
order_group_id: order.order_group_id ?? null,
client_order_id: order.client_order_id ?? null,
place_count: order.place_count ?? null,
decrease_count: order.decrease_count ?? null,
queue_position: order.queue_position ?? null,
maker_fill_count: order.maker_fill_count ?? null,
taker_fill_count: order.taker_fill_count ?? null,
maker_fees: order.maker_fees ?? null,
taker_fees: order.taker_fees ?? null,
last_update_time: order.last_update_time ?? null,
take_profit_order_id: order.take_profit_order_id ?? null,
stop_loss_order_id: order.stop_loss_order_id ?? null,
amend_count: order.amend_count ?? null,
amend_taker_fill_count: order.amend_taker_fill_count ?? null,
})
return {
success: true,
output: {
old_order: mapOrder(data.old_order || {}),
order: mapOrder(data.order || {}),
},
}
},
outputs: {
old_order: {
type: 'object',
description: 'The original order object before amendment',
properties: {
order_id: { type: 'string', description: 'Order ID' },
user_id: { type: 'string', description: 'User ID' },
ticker: { type: 'string', description: 'Market ticker' },
event_ticker: { type: 'string', description: 'Event ticker' },
status: { type: 'string', description: 'Order status' },
side: { type: 'string', description: 'Order side (yes/no)' },
type: { type: 'string', description: 'Order type (limit/market)' },
yes_price: { type: 'number', description: 'Yes price in cents' },
no_price: { type: 'number', description: 'No price in cents' },
action: { type: 'string', description: 'Action (buy/sell)' },
count: { type: 'number', description: 'Number of contracts' },
remaining_count: { type: 'number', description: 'Remaining contracts' },
created_time: { type: 'string', description: 'Order creation time' },
expiration_time: { type: 'string', description: 'Order expiration time' },
order_group_id: { type: 'string', description: 'Order group ID' },
client_order_id: { type: 'string', description: 'Client order ID' },
place_count: { type: 'number', description: 'Place count' },
decrease_count: { type: 'number', description: 'Decrease count' },
queue_position: { type: 'number', description: 'Queue position' },
maker_fill_count: { type: 'number', description: 'Maker fill count' },
taker_fill_count: { type: 'number', description: 'Taker fill count' },
maker_fees: { type: 'number', description: 'Maker fees' },
taker_fees: { type: 'number', description: 'Taker fees' },
last_update_time: { type: 'string', description: 'Last update time' },
take_profit_order_id: { type: 'string', description: 'Take profit order ID' },
stop_loss_order_id: { type: 'string', description: 'Stop loss order ID' },
amend_count: { type: 'number', description: 'Amend count' },
amend_taker_fill_count: { type: 'number', description: 'Amend taker fill count' },
},
},
order: {
type: 'object',
description: 'The amended order object with full API response fields',
properties: {
order_id: { type: 'string', description: 'Order ID' },
user_id: { type: 'string', description: 'User ID' },
ticker: { type: 'string', description: 'Market ticker' },
event_ticker: { type: 'string', description: 'Event ticker' },
status: { type: 'string', description: 'Order status' },
side: { type: 'string', description: 'Order side (yes/no)' },
type: { type: 'string', description: 'Order type (limit/market)' },
yes_price: { type: 'number', description: 'Yes price in cents' },
no_price: { type: 'number', description: 'No price in cents' },
action: { type: 'string', description: 'Action (buy/sell)' },
count: { type: 'number', description: 'Number of contracts' },
remaining_count: { type: 'number', description: 'Remaining contracts' },
created_time: { type: 'string', description: 'Order creation time' },
expiration_time: { type: 'string', description: 'Order expiration time' },
order_group_id: { type: 'string', description: 'Order group ID' },
client_order_id: { type: 'string', description: 'Client order ID' },
place_count: { type: 'number', description: 'Place count' },
decrease_count: { type: 'number', description: 'Decrease count' },
queue_position: { type: 'number', description: 'Queue position' },
maker_fill_count: { type: 'number', description: 'Maker fill count' },
taker_fill_count: { type: 'number', description: 'Taker fill count' },
maker_fees: { type: 'number', description: 'Maker fees' },
taker_fees: { type: 'number', description: 'Taker fees' },
last_update_time: { type: 'string', description: 'Last update time' },
take_profit_order_id: { type: 'string', description: 'Take profit order ID' },
stop_loss_order_id: { type: 'string', description: 'Stop loss order ID' },
amend_count: { type: 'number', description: 'Amend count' },
amend_taker_fill_count: { type: 'number', description: 'Amend taker fill count' },
},
},
},
}