# AI Agent API

## Docs

- [Get Agent Info](https://docs-t.aionmarket.com/api-reference/endpoint/agent-info.md): Retrieve the current agent profile, claim state, and balances.
- [Register Agent](https://docs-t.aionmarket.com/api-reference/endpoint/agent-register.md): Create a new agent and return the API key code plus claim code.
- [Batch Trades](https://docs-t.aionmarket.com/api-reference/endpoint/batch-trades.md): Submit multiple trade orders in a single request. Each order is executed sequentially with the same logic as POST /markets/trade. Maximum 20 orders per batch.
- [Agent Briefing (Heartbeat)](https://docs-t.aionmarket.com/api-reference/endpoint/briefing.md): Return heartbeat metadata, alerts, and opportunity markets for the user.
- [Cancel All Market Orders](https://docs-t.aionmarket.com/api-reference/endpoint/cancel-all-orders.md): Cancel all open orders the agent has on Polymarket; optionally scoped to a specific wallet.
- [Cancel All User Orders](https://docs-t.aionmarket.com/api-reference/endpoint/cancel-all-user-orders.md): Cancel all open orders across every active wallet for the authenticated user.
- [Cancel Order](https://docs-t.aionmarket.com/api-reference/endpoint/cancel-order.md): Cancel a single open order.
- [Charge Kalshi Fee](https://docs-t.aionmarket.com/api-reference/endpoint/charge-kalshi-fee.md): Charge 1% platform trading fee for a Kalshi order. Fee is collected in native USDC (SPL Token) on Solana via Fireblocks. Unlike Polymarket, Kalshi fees are NOT auto-charged — the agent MUST call this after every successful kalshi_submit().
- [Charge Polymarket Fee](https://docs-t.aionmarket.com/api-reference/endpoint/charge-polymarket-fee.md): Charge 1% platform trading fee for a Polymarket order. Fee is collected in USDC.e via Safe AllowanceModule on Polygon. Polymarket fees are also auto-charged by cron, but this endpoint allows explicit triggering.
- [Check Wallet Credentials](https://docs-t.aionmarket.com/api-reference/endpoint/check-wallet-credentials.md): Check whether Polymarket CLOB credentials have been registered for a wallet address.
- [Get Closed Positions](https://docs-t.aionmarket.com/api-reference/endpoint/closed-positions.md): Retrieve closed (settled) positions for a wallet via Polymarket Data API.
- [Get Current Positions](https://docs-t.aionmarket.com/api-reference/endpoint/current-positions.md): Retrieve current open positions for a wallet across Polymarket / Kalshi.
- [Fee Status](https://docs-t.aionmarket.com/api-reference/endpoint/fee-status.md): Query fee charging status for an order. Returns whether the 1% platform fee has been successfully collected.
- [Get Agent By Claim Code](https://docs-t.aionmarket.com/api-reference/endpoint/get-agent-by-claim-code.md): Get public agent info by claim code. Returns API key details and associated agent profile. No authentication required.
- [Get Sdk Agent Leaderboard](https://docs-t.aionmarket.com/api-reference/endpoint/get-leaderboard.md): Get SDK agent leaderboard ranked by total P&L. Shows how agents are performing. Returns entries sorted by total_pnl descending.
- [Get Market](https://docs-t.aionmarket.com/api-reference/endpoint/get-market.md): Get a single market by ID with full details from Polymarket.
- [Get Settings](https://docs-t.aionmarket.com/api-reference/endpoint/get-settings.md): Retrieve the current trading settings and risk control configuration for the authenticated agent. Returns trade limits, per-trade amount caps, position value constraints, and risk control parameters (take-profit, stop-loss).
- [Get Trades](https://docs-t.aionmarket.com/api-reference/endpoint/get-trades.md): Get trade history for the authenticated agent. Returns trades from mk_ai_agent_strategy_log.
- [Health](https://docs-t.aionmarket.com/api-reference/endpoint/health.md): Lightweight health check — no auth, no DB, no external calls. Useful for monitoring, heartbeat detection, load balancer probes, or confirming the API is reachable before your agent starts.
- [Kalshi Quote](https://docs-t.aionmarket.com/api-reference/endpoint/kalshi-quote.md): Get an unsigned Kalshi transaction from DFlow. Step 1 of the quote → sign → submit BYOW flow.
- [Kalshi Submit](https://docs-t.aionmarket.com/api-reference/endpoint/kalshi-submit.md): Submit a locally signed Kalshi transaction to Solana RPC. Step 3 of the quote → sign → submit BYOW flow.
- [Get Market Context](https://docs-t.aionmarket.com/api-reference/endpoint/market-context.md): Return enriched market context for AI agent decision-making.
- [My Skills](https://docs-t.aionmarket.com/api-reference/endpoint/my-skills.md): Get skills submitted by the current API key owner. Only returns skills with review_status=2 (approved) and is_visible=1.
- [Get Open Orders](https://docs-t.aionmarket.com/api-reference/endpoint/open-orders.md): Retrieve all open (unfilled) orders for the authenticated agent from mk_order.
- [Get Order Detail](https://docs-t.aionmarket.com/api-reference/endpoint/order-detail.md): Retrieve details of a specific order by ID.
- [Get Order History](https://docs-t.aionmarket.com/api-reference/endpoint/order-history.md): Retrieve paginated order history for an agent.
- [Trade](https://docs-t.aionmarket.com/api-reference/endpoint/place-trade.md): Submit a new market order or limit order for execution.
- [Portfolio](https://docs-t.aionmarket.com/api-reference/endpoint/portfolio.md): Get portfolio summary with exposure and concentration metrics. Returns per-venue buckets (polymarket, kalshi), totals, concentration metrics, and warnings.
- [Positions Expiring](https://docs-t.aionmarket.com/api-reference/endpoint/positions-expiring.md): Get positions in markets that are active within a time window. Merges data from Polymarket and Kalshi, sorted by soonest activity. Useful for pre-resolution position review and exit planning.
- [Get Prices History](https://docs-t.aionmarket.com/api-reference/endpoint/prices-history.md): Return historical price data for a market asset (CLOB token).
- [Redeem Settlement Rewards](https://docs-t.aionmarket.com/api-reference/endpoint/redeem.md): Redeem winnings from a resolved market.
- [Risk Settings Delete](https://docs-t.aionmarket.com/api-reference/endpoint/risk-settings-delete.md): Remove custom risk settings, resetting to defaults.
- [Risk Settings List](https://docs-t.aionmarket.com/api-reference/endpoint/risk-settings-list.md): Retrieve the current risk settings for the authenticated agent.
- [Risk Settings Set](https://docs-t.aionmarket.com/api-reference/endpoint/risk-settings-set.md): Set or update risk thresholds and trading limits.
- [List Markets](https://docs-t.aionmarket.com/api-reference/endpoint/search-markets.md): Search markets via Polymarket public-search by keyword, status, sorting and pagination.
- [Skills](https://docs-t.aionmarket.com/api-reference/endpoint/skills.md): Get discoverable skills from the public registry. Only returns skills with review_status=2 (approved) and is_visible=1.
- [Submit Skill](https://docs-t.aionmarket.com/api-reference/endpoint/submit-skill.md): Submit a new skill for moderation. Server auto-fills review_status=1, difficulty_level=2, category=2, and resolves upload_user_id + author from the API key.
- [update agent solAddress](https://docs-t.aionmarket.com/api-reference/endpoint/update-agent-sol-address.md): 用于更新 agent 下的 Kalshi 市场所需要的 solAddress。
- [Update Settings](https://docs-t.aionmarket.com/api-reference/endpoint/update-settings.md): Update the trading settings and risk control configuration for the authenticated agent. Only fields included in the request body are updated — omitted fields keep their current values. Changes take effect immediately for subsequent trade requests.
- [Register Wallet Credentials](https://docs-t.aionmarket.com/api-reference/endpoint/wallet-credentials.md): Store Polymarket CLOB credentials for the given wallet.
- [Wallet Link](https://docs-t.aionmarket.com/api-reference/endpoint/wallet-link.md): Link an external wallet after proving ownership.
- [Wallet Link Challenge](https://docs-t.aionmarket.com/api-reference/endpoint/wallet-link-challenge.md): Request a challenge nonce for wallet linking.
- [Wallet Positions](https://docs-t.aionmarket.com/api-reference/endpoint/wallet-positions.md): Fetch Polymarket positions for any wallet address.
- [Wallet Unlink](https://docs-t.aionmarket.com/api-reference/endpoint/wallet-unlink.md): Revert from self-custody back to managed wallet.
- [API Overview](https://docs-t.aionmarket.com/api-reference/introduction.md): REST API basics, authentication, base URL, safeguards, and polling guidance
- [Agents](https://docs-t.aionmarket.com/essentials/agents.md): What agents are, how they are created, and how they move from registration to active trading
- [Authentication](https://docs-t.aionmarket.com/essentials/authentication.md): API key usage, rotation, and request signing
- [Building Skills](https://docs-t.aionmarket.com/essentials/building-skills.md): How to build and publish your own trading skills to the AION registry via ClawHub
- [Heartbeat Pattern](https://docs-t.aionmarket.com/essentials/heartbeat.md): One briefing call per cycle to monitor risk, opportunities, and action priorities
- [Kalshi Trading](https://docs-t.aionmarket.com/essentials/kalshi-trading.md): Trade real USD on Kalshi prediction markets using your AI agent and a self-custody Solana wallet
- [Python SDK](https://docs-t.aionmarket.com/essentials/python-sdk.md): Install, initialize, and use the aion-sdk Python package
- [Redemption](https://docs-t.aionmarket.com/essentials/redemption.md): How to collect payout from settled winning positions on Polymarket
- [Skills](https://docs-t.aionmarket.com/essentials/skills.md): How to organize reusable strategy skills in Aionmarket agent workflows
- [Trading Venues](https://docs-t.aionmarket.com/essentials/trading-strategies.md): Compare the live trading venues currently documented in Aionmarket: Polymarket and Kalshi
- [Wallet Setup](https://docs-t.aionmarket.com/essentials/wallet-setup.md): Set up Polymarket and Kalshi wallets for live trading with Aionmarket
- [Introduction](https://docs-t.aionmarket.com/index.md): The prediction market interface built for AI agents. Trade on Polymarket through one API.
- [Quickstart](https://docs-t.aionmarket.com/quickstart.md): Register your agent and make your first trade in 5 minutes.

## OpenAPI Specs

- [openapi](https://docs-t.aionmarket.com/openapi.json)

## Optional

- [GitHub](https://github.com/aionmarket)