Placing Your First Order

This guide shows you the minimum required code to build, sign, and submit a transaction to place an order on Decibel.

Prerequisites

Before you begin, make sure you have:

Generated an API key from https://app.decibel.trade/api
Your private key (keep this secure!)
APT in your account for gas fees (or set up Geomi Gas Station to sponsor gas)

Configuration Variables

Before placing an order, you’ll need to set these configuration variables:

PACKAGE=0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06

PACKAGE=0xe7da2794b1d8af76532ed95f38bfdf1136abfd8ea3a240189971988a83101b7f

Minimum Required Code

Here’s the minimal code needed to place an order:

import {
  Aptos,
  AptosConfig,
  Ed25519Account,
  Ed25519PrivateKey,
  Network,
} from "@aptos-labs/ts-sdk";

// Configuration
const PACKAGE = "0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06";

// Your private key (keep this secure!)
const privateKey = "0x..."; // Your private key in hex format

// Create account from private key
const account = new Ed25519Account({
  privateKey: new Ed25519PrivateKey(privateKey),
});

// Initialize Aptos client
const aptosConfig = new AptosConfig({
  network: Network.MAINNET,
});
const aptos = new Aptos(aptosConfig);

// Build the transaction
const transaction = await aptos.transaction.build.simple({
  sender: account.accountAddress,
  data: {
    function: `${PACKAGE}::dex_accounts_entry::place_order_to_subaccount`,
    typeArguments: [],
    functionArguments: [
      "0x123...abc", // subaccountAddr
      "0x456...def", // marketAddr (PerpMarket object address)
      5670000000, // price (5.67 with 9 decimals)
      1000000000, // size (1.0 with 9 decimals)
      true, // isBuy (true for buy, false for sell)
      0, // timeInForce (0 = GoodTillCanceled, 1 = PostOnly, 2 = ImmediateOrCancel)
      false, // isReduceOnly
      null, // clientOrderId (optional)
      null, // stopPrice (optional)
      null, // tpTriggerPrice (optional)
      null, // tpLimitPrice (optional)
      null, // slTriggerPrice (optional)
      null, // slLimitPrice (optional)
      null, // builderAddress (optional)
      null, // builderFees (optional)
    ],
  },
});

// Sign the transaction
const senderAuthenticator = aptos.transaction.sign({
  signer: account,
  transaction,
});

// Submit the transaction
const pendingTransaction = await aptos.transaction.submit.simple({
  transaction,
  senderAuthenticator,
});

// Wait for confirmation
const executedTx = await aptos.waitForTransaction({
  transactionHash: pendingTransaction.hash,
});

console.log("Order placed successfully!");
console.log("Transaction Hash:", executedTx.hash);

import {
  Aptos,
  AptosConfig,
  Ed25519Account,
  Ed25519PrivateKey,
  Network,
} from "@aptos-labs/ts-sdk";

// Configuration
const PACKAGE = "0xe7da2794b1d8af76532ed95f38bfdf1136abfd8ea3a240189971988a83101b7f";

// Your private key (keep this secure!)
const privateKey = "0x..."; // Your private key in hex format

// Create account from private key
const account = new Ed25519Account({
  privateKey: new Ed25519PrivateKey(privateKey),
});

// Initialize Aptos client
const aptosConfig = new AptosConfig({
  network: Network.TESTNET,
});
const aptos = new Aptos(aptosConfig);

// Build the transaction
const transaction = await aptos.transaction.build.simple({
  sender: account.accountAddress,
  data: {
    function: `${PACKAGE}::dex_accounts_entry::place_order_to_subaccount`,
    typeArguments: [],
    functionArguments: [
      "0x123...abc", // subaccountAddr
      "0x456...def", // marketAddr (PerpMarket object address)
      5670000000, // price (5.67 with 9 decimals)
      1000000000, // size (1.0 with 9 decimals)
      true, // isBuy (true for buy, false for sell)
      0, // timeInForce (0 = GoodTillCanceled, 1 = PostOnly, 2 = ImmediateOrCancel)
      false, // isReduceOnly
      null, // clientOrderId (optional)
      null, // stopPrice (optional)
      null, // tpTriggerPrice (optional)
      null, // tpLimitPrice (optional)
      null, // slTriggerPrice (optional)
      null, // slLimitPrice (optional)
      null, // builderAddress (optional)
      null, // builderFees (optional)
    ],
  },
});

// Sign the transaction
const senderAuthenticator = aptos.transaction.sign({
  signer: account,
  transaction,
});

// Submit the transaction
const pendingTransaction = await aptos.transaction.submit.simple({
  transaction,
  senderAuthenticator,
});

// Wait for confirmation
const executedTx = await aptos.waitForTransaction({
  transactionHash: pendingTransaction.hash,
});

console.log("Order placed successfully!");
console.log("Transaction Hash:", executedTx.hash);

from aptos_sdk.account import Account
from aptos_sdk.client import RestClient
from aptos_sdk.account_address import AccountAddress

# Configuration
PACKAGE = "0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06"
FULLNODE_URL = "https://api.mainnet.aptoslabs.com/v1"

# Your private key (keep this secure!)
private_key = "0x..."  # Your private key in hex format

# Create account from private key
account = Account.load_key(private_key)

# Initialize Aptos client
rest_client = RestClient(FULLNODE_URL)

# Build the transaction
transaction = rest_client.build_transaction(
    sender=account.address(),
    payload={
        "function": f"{PACKAGE}::dex_accounts_entry::place_order_to_subaccount",
        "type_arguments": [],
        "function_arguments": [
            "0x123...abc",  # subaccountAddr
            "0x456...def",  # marketAddr (PerpMarket object address)
            5670000000,  # price (5.67 with 9 decimals)
            1000000000,  # size (1.0 with 9 decimals)
            True,  # isBuy (true for buy, false for sell)
            0,  # timeInForce (0 = GoodTillCanceled, 1 = PostOnly, 2 = ImmediateOrCancel)
            False,  # isReduceOnly
            None,  # clientOrderId (optional)
            None,  # stopPrice (optional)
            None,  # tpTriggerPrice (optional)
            None,  # tpLimitPrice (optional)
            None,  # slTriggerPrice (optional)
            None,  # slLimitPrice (optional)
            None,  # builderAddress (optional)
            None,  # builderFees (optional)
        ],
    },
)

# Sign the transaction
signed_transaction = account.sign(transaction)

# Submit the transaction
pending_transaction = rest_client.submit_transaction(signed_transaction)

# Wait for confirmation
executed_tx = rest_client.wait_for_transaction(pending_transaction)

print("Order placed successfully!")
print(f"Transaction Hash: {executed_tx['hash']}")

from aptos_sdk.account import Account
from aptos_sdk.client import RestClient
from aptos_sdk.account_address import AccountAddress

# Configuration
PACKAGE = "0xe7da2794b1d8af76532ed95f38bfdf1136abfd8ea3a240189971988a83101b7f"
FULLNODE_URL = "https://api.testnet.aptoslabs.com/v1"

# Your private key (keep this secure!)
private_key = "0x..."  # Your private key in hex format

# Create account from private key
account = Account.load_key(private_key)

# Initialize Aptos client
rest_client = RestClient(FULLNODE_URL)

# Build the transaction
transaction = rest_client.build_transaction(
    sender=account.address(),
    payload={
        "function": f"{PACKAGE}::dex_accounts_entry::place_order_to_subaccount",
        "type_arguments": [],
        "function_arguments": [
            "0x123...abc",  # subaccountAddr
            "0x456...def",  # marketAddr (PerpMarket object address)
            5670000000,  # price (5.67 with 9 decimals)
            1000000000,  # size (1.0 with 9 decimals)
            True,  # isBuy (true for buy, false for sell)
            0,  # timeInForce (0 = GoodTillCanceled, 1 = PostOnly, 2 = ImmediateOrCancel)
            False,  # isReduceOnly
            None,  # clientOrderId (optional)
            None,  # stopPrice (optional)
            None,  # tpTriggerPrice (optional)
            None,  # tpLimitPrice (optional)
            None,  # slTriggerPrice (optional)
            None,  # slLimitPrice (optional)
            None,  # builderAddress (optional)
            None,  # builderFees (optional)
        ],
    },
)

# Sign the transaction
signed_transaction = account.sign(transaction)

# Submit the transaction
pending_transaction = rest_client.submit_transaction(signed_transaction)

# Wait for confirmation
executed_tx = rest_client.wait_for_transaction(pending_transaction)

print("Order placed successfully!")
print(f"Transaction Hash: {executed_tx['hash']}")

What This Code Does

Imports: Imports the necessary classes from @aptos-labs/ts-sdk (TypeScript) or aptos-sdk (Python)
Account Setup: Creates an account from your private key
Client Initialization: Initializes the Aptos client with the network configuration
Transaction Building: Builds a transaction calling place_order_to_subaccount with your order parameters
Signing: Signs the transaction with your private key
Submission: Submits the signed transaction to the blockchain
Confirmation: Waits for the transaction to be confirmed

Next Steps

For more detailed information, see:

Place Order Transaction - Complete documentation for placing orders
Formatting Prices and Sizes - Learn how to format prices and sizes correctly
Optimized Transaction Building - Learn how to build transactions synchronously for better performance
Authenticated Requests - Overview of authenticated requests

Note: This example uses mock addresses for subaccountAddr and marketAddr. In a real application, you’ll need to: - Get your Trading Account address (see Create Trading Account) - Get the market address from the v1/markets API endpoint - Format prices and sizes correctly using market configuration (see Formatting Prices and Sizes)

Security: Never expose your private key in client-side code or commit it to version control. Use environment variables or secure key management systems.

Quick Start

Guides

TypeScript SDK

CLI

On-Chain: Reference

On-Chain: Account Management

On-Chain: Order Management

On-Chain: Position Management

On-Chain: Builder Fee

On-Chain: Vault Transactions

Placing Your First Order