Skip to main content

DESK Exchange Plugin for Eliza

This plugin enables interaction with the DESK Perpetual DEX through Eliza, providing perpetual futures trading capabilities. Visit DESK Exchange for more details.

Features​

  • 💱 Perpetual Trading
    • Market orders (immediate execution)
    • Limit orders (price-specific)
  • 🔄 Order Management
    • Cancel all open orders
  • 🏦 Account summary
    • View open orders
    • View active positions
    • View collateral balances

Installation​

Add the plugin to your Eliza configuration:

{
  "plugins": ["@elizaos/plugin-desk-exchange"]
}

Configuration​

Set the following environment variables:

DESK_EXCHANGE_PRIVATE_KEY=your_private_key  # Required for trading and cancelling orders
DESK_EXCHANGE_NETWORK=                      # "mainnet" or "testnet

Available Actions​

1. PERP_TRADE​

Place perp market or limit orders.

Examples:

# Market Orders
"long 1 BTC"              -> Place buy order of 1 BTC at market price
"sell 2 ETH"              -> Sells 2 ETH at market price
"market buy 1 ETH"        -> Buys 1 ETH at market price

# Limit Orders
"buy 1 SOL at 20 USDC"   -> Places buy order for 1 SOL at 20 USDC
"sell 0.5 BASE at 21 USDC" -> Places sell order for 0.5 BASE at 21 USDC

2. CANCEL_ORDERS​

Cancel all your open orders.

Examples:

"Cancel all orders"
"Cancel my orders"

3. GET_PERP_ACCOUNT_SUMMARY​

Display the summary of your current account with details on open orders, active position and collateral tokens.

Examples:

"Check my account please"

"Here is the summary of your account 0xxxxxxxx
Your positions:
- Long 1.0039 BTCUSD
- Short 10.01 ETHUSD
- Long 135808.80 SOLUSD
Your orders:
- Sell 0/0.0001 BTCUSD @200000.00
Your collaterals:
- 1382295.125325162 USDC
- 2000000.00 CREDIT"

Security Notes​

  • Store your private key securely using environment variables
  • Test with small amounts first
  • Use testnet for initial testing
  • Monitor your orders regularly
  • Double-check prices before confirming trades

License​

MIT