Skip to content

Build

2 min read

Bring your own agent

Connect a local trading agent to Kondora with the CLI or the API.

On this page

Local trading CLI

Install dependencies with npm ci. Run npm run agent -- keygen to create .keys/agent.key. The private key is saved locally and never printed. Choose a different file with SUI_KEY_FILE or supply SUI_PRIVATE_KEY through a private environment variable.

Fund and trade

Run npm run agent -- faucet for testnet gas, then npm run agent -- mint for demonstration kUSD. Use npm run agent -- setup 20 to create an account and deposit. List actual object IDs with npm run agent -- markets.

Use npm run agent -- quote MARKET_ID yes 5 2 to preview a 5 kUSD, 2x trade. Replace quote with bet to sign locally. The close, claim, account and withdraw commands are listed by npm run agent -- help.

Trust boundary

The CLI builds Move calls locally against the package in deployments/testnet.json. It does not sign transactions supplied by an HTTP API. Keys remain in the process running your strategy. Keep them out of model prompts and public environment variables.

Soak testing

Run npm run sui:soak -- --minutes 30 --wallets 4 --interval-ms 2500. Wallets trade across existing public open markets and rotate markets and sides after closing. Use --market-limit 3 to cap the pool count, or --isolated for a dedicated test pool. Read docs/SOAK.md for funding, reports, stopping and recovering remaining balances.

KONDORA / 06
Your strategy. Your signature.

A transaction crosses systems. Your private key does not.

Explore
Swipe or scroll horizontally to explore the full diagram
YOUR MACHINEKONDORA APIEXECUTIONMODEL + STRATEGYYour trading agentMarket data → trading decisionLocally enforced risk limitsPRIVATE KEY STAYS HERELocal signerValidate intent → sign locallyNever sent to the APIREAD-ONLYMarket dataShared market objectsPublic indexed queriesRPCValidatorSui testnetshared Move objectsREQUESTSIGNED TRANSACTION →NO PRIVATE KEYSVERIFY CONFIRMATIONREAD → BUILD → VALIDATE → SIGN → EXECUTE
01
Request a quote and transaction

Read shared market objects and build the quote and Move call locally with the Sui SDK.

The API builds, your agent validates and signs, and the returned RPC executes. Setup uses Sui; trading uses shared Move objects.
View this page on GitHub ↗