Page cover

API Reference: Julia Backend Commands

This page lists the commands processed by the Julia backend server, typically invoked via the Node.js or Python bridge.

(Note: This list is based on inferred functionality and previous documentation. The exact command names, parameters, and return values should be verified against the command handler logic in /julia/julia_server.jl and the relevant Julia modules in /julia/src/)

Command Format

Commands are typically sent as JSON objects with a command field (e.g., "agents.create_agent") and a payload field containing parameters.

{
  "command": "category.action",
  "payload": { "param1": "value1", "param2": 123 }
}

Agent Commands

Command
Description
Payload Parameters
Example Payload
Return Value

agents.create_agent

Create a new agent

name (String), type (String), config (Dict)

{"name": "MyAgent", "type": "Trading", "config": {"risk": 0.5}}

Agent ID or Agent object

agents.list_agents

List all managed agents

None

{}

Array of Agent objects or IDs

agents.get_agent

Retrieve details for a specific agent

id (String)

{"id": "agent-uuid-123"}

Agent object

agents.start_agent

Start a specific agent

id (String)

{"id": "agent-uuid-123"}

Status confirmation

agents.stop_agent

Stop a specific agent

id (String)

{"id": "agent-uuid-123"}

Status confirmation

agents.delete_agent

Delete a specific agent

id (String)

{"id": "agent-uuid-123"}

Status confirmation

agents.update_config

Update configuration for an agent

id (String), config (Dict)

{"id": "agent-uuid-123", "config": {"risk": 0.6}}

Status confirmation

Swarm Commands

Command
Description
Payload Parameters
Example Payload
Return Value

swarms.create_swarm

Create a new swarm

name (String), algorithm (Dict), config (Dict)

{"name": "MySwarm", "algorithm": {"type":"PSO", "params":{...}}, "config": {"pairs": [...]}}

Swarm ID or Swarm object

swarms.list_swarms

List all managed swarms

None

{}

Array of Swarm objects or IDs

swarms.get_swarm

Retrieve details for a specific swarm

id (String)

{"id": "swarm-uuid-456"}

Swarm object

swarms.start_swarm

Start optimization/operation for a swarm

id (String)

{"id": "swarm-uuid-456"}

Status confirmation

swarms.stop_swarm

Stop a specific swarm

id (String)

{"id": "swarm-uuid-456"}

Status confirmation

swarms.delete_swarm

Delete a specific swarm

id (String)

{"id": "swarm-uuid-456"}

Status confirmation

swarms.add_agent

Add an agent to a swarm

swarm_id (String), agent_id (String)

{"swarm_id": "swarm-456", "agent_id": "agent-123"}

Status confirmation

swarms.remove_agent

Remove an agent from a swarm

swarm_id (String), agent_id (String)

{"swarm_id": "swarm-456", "agent_id": "agent-123"}

Status confirmation

Wallet Commands (Backend - Use with Caution)

Command
Description
Payload Parameters
Example Payload
Return Value

wallets.get_wallets

List backend-managed wallets

None

{}

Mock List

wallets.get_wallet_info

Get info for a backend wallet

wallet_id (String)

{"wallet_id":"wallet1"}

Mock Info

wallets.create_wallet

Create new backend wallet (INSECURE if keys stored)

name (String)

{"name":"AgentWallet"}

Mock Wallet

wallets.import_wallet

Import backend wallet (INSECURE)

name, private_key, chain

{...}

Mock Wallet

wallets.export_wallet

Export backend wallet key (INSECURE)

wallet_id, chain

{...}

Mock Key

Bridge / Blockchain / DEX Commands

Command
Description
Payload Parameters
Example Payload
Return Value

bridge.get_token_address

Resolve token symbol to address

symbol (String), chain (String)

{"symbol":"WETH", "chain":"ethereum"}

Address Dict or Error

blockchain.get_balance

Get native/token balance

address, chain, token_address (opt)

{"address":"0x...", "chain":"base"}

Balance Dict or Error

dex.get_swap_quote

Get quote for a DEX swap

token_in, token_out, amount_in_wei, dex_name, chain

{...}

Quote Dict or Error

bridge.execute_trade

Prepare unsigned swap TX

dex, chain, trade_params (Dict: token_in, token_out, amount_in_wei, slippage, wallet_address)

{...}

Unsigned TX Dict or Error

bridge.submit_signed_transaction

Submit client-signed TX

chain, request_id, signed_tx_hex

{...}

Submission Result Dict

bridge.get_transaction_status

Check submitted TX status

chain, tx_hash

{"chain":"polygon", "tx_hash":"0x..."}

Status Dict or Error

bridges.[protocol].transfer

Initiate cross-chain transfer

Varies by protocol

{...}

Transfer ID/Tx Hash

bridges.[protocol].getStatus

Check cross-chain status

transferId

{...}

Status string

System Commands

Command
Description
Payload Parameters
Example Payload
Return Value

system.get_status

Get overall system status

None

{}

Status object

system.get_metrics

Get performance metrics

None

{}

Metrics object

system.ping

Basic health check

None

{}

"pong"