Managing Your Orders

Learn how to track your open orders and manage your trading activity on Vita CLOB.

Viewing Open Orders

Order Management Interface

Open Orders Interface — View and manage all your active orders in one place

Your open orders display shows:

Order ID: Unique identifier for each order
Type/Side: Limit/Market and Buy/Sell
Price: Your specified limit price
Filled/Remaining: How much has been executed
Actions: Cancel or modify options

Querying Open Orders

// Direct contract interaction - No SDK available
const web3 = new Web3(window.ethereum);
const vitaCLOB = new web3.eth.Contract(VITA_CLOB_ABI, "[TBD]");

// Get all open orders for a market
const openOrders = await vitaCLOB.methods.getOpenOrders(
  marketId,      // Market ID (e.g., "1" for NEAR-USDC)
  userAddress    // Your account address
).call();

// Response structure
openOrders.forEach(order => {
  console.log({
    id: order.id,
    price: order.limit_price,
    openQty: order.open_qty,
    originalQty: order.original_qty,
    isBuy: order.is_buy,
    timestamp: order.timestamp
  });
});

# View your open orders via Near CLI
near view [TBD] get_open_orders '{
  "market_id": "1",
  "account_id": "user.near"
}'

Single Order Query

To check a specific order:

// Direct contract interaction - No SDK available
const web3 = new Web3(window.ethereum);
const vitaCLOB = new web3.eth.Contract(VITA_CLOB_ABI, "[TBD]");

// Get details of a specific order
const orderDetails = await vitaCLOB.methods.getOpenOrder(
  marketId,      // Market ID
  userAddress,   // Your account
  orderId        // Specific order ID
).call();

# Query specific order
near view [TBD] get_open_order '{
  "market_id": "1",
  "account_id": "user.near",
  "order_id": "12345"
}'

Order Information Structure

interface OpenLimitOrderView {
  id: string;                    // Order ID (u128)
  limit_price: string;           // Price in smallest units
  open_qty: string;              // Remaining quantity
  original_qty?: string;         // Initial order size
  is_buy: boolean;               // true = buy, false = sell
  timestamp?: string;            // Creation timestamp
  user_id?: string;              // Order owner
}

Order Status Tracking

Partial Fills

Orders can be partially filled when:

Insufficient liquidity at your price
Match limit reached (50 matches default)
Market moves away from your price

Partially filled orders remain active for the unfilled portion until completed or cancelled

Order Completion

Orders are automatically removed from the book when:

Fully filled
Cancelled by user
Market becomes inactive

Order Events

Track order lifecycle through events:

New Order Event

{
  account_id: "user.near",
  market_id: "1",
  order_id: "12345",
  is_buy: true,
  is_limit: true,
  quantity: "1000000000000000000000000",
  open_quantity: "1000000000000000000000000",
  limit_price: "495000000",
  taker_fee: "0"
}

Fill Order Event

{
  order_id: "12345",
  market_id: "1",
  fill_qty: "500000000000000000000000",
  fill_price: "495000000",
  quote_qty: "2475000000",
  maker_order_id: "67890",
  is_buy: true,
  taker_account_id: "user.near",
  maker_account_id: "maker.near"
}

Best Practices

Monitor Regularly

Check open orders frequently, especially in volatile markets

Track Performance

Monitor your trading performance and adjust strategies accordingly

Always monitor your open orders, especially during high volatility. Unfilled limit orders may execute at unexpected times as market conditions change.

Cancelling Orders

Cancel Single Order

// Direct contract interaction - No SDK available
const web3 = new Web3(window.ethereum);
const vitaCLOB = new web3.eth.Contract(VITA_CLOB_ABI, "[TBD]");

// Cancel a specific order
await vitaCLOB.methods.cancelOrder(
  orderId  // Order ID to cancel
).send({ 
  from: userAddress,
  gas: "30000000000000"  // 30 TGas ≈ 0.003 NEAR
});

# Cancel order via Near CLI
near call [TBD] cancel_order '{
  "order_id": "123456789"
}' --accountId user.near --gas 30000000000000

Cancel Multiple Orders

// Cancel multiple orders at once
await vitaCLOB.methods.cancelOrders(
  [orderId1, orderId2, orderId3]  // Array of order IDs
).send({ 
  from: userAddress,
  gas: "50000000000000"  // 50 TGas for multiple cancellations
});

# Cancel multiple orders
near call [TBD] cancel_orders '{
  "order_ids": ["123456789", "987654321", "456789123"]
}' --accountId user.near --gas 50000000000000

Partially filled orders can be cancelled. The filled portion remains executed, only the remaining open quantity is cancelled.

Market Depth Analysis

Check market depth before placing orders:

// Direct contract interaction - No SDK available
const web3 = new Web3(window.ethereum);
const vitaCLOB = new web3.eth.Contract(VITA_CLOB_ABI, "[TBD]");

// Query order book depth
const orderbook = await vitaCLOB.methods.getOrderbookDepth(
  marketId  // Market ID
).call();

// Analyze liquidity
console.log("Bids:", orderbook.bids);
console.log("Asks:", orderbook.asks);
console.log("Spread:", orderbook.spread);

# View order book depth
near view [TBD] get_orderbook_depth '{"market_id": "1"}'

Troubleshooting Orders

Order not showing in open orders

Possible reasons:

Order already filled
Order cancelled
Querying wrong market ID
Network delay (wait a few seconds)

Partial fill stuck

If your order is partially filled and not completing:

Check current market price
Verify liquidity at your price level
Consider adjusting price or cancelling

Cannot cancel order

Cancellation may fail if:

Order already fully filled
Order ID incorrect
Network issues
Insufficient gas (need ~0.003 NEAR)

API Reference

Query Methods

Method	Description	Parameters
`get_open_orders`	Get all open orders	market_id, account_id
`get_open_order`	Get specific order	market_id, account_id, order_id
`get_orderbook_depth`	Get order book	market_id

Order Management Methods

Method	Description	Gas
`cancel_order`	Cancel single order	~30 TGas (0.003 NEAR)
`cancel_orders`	Cancel multiple orders	~50 TGas (0.005 NEAR)

Getting Started

Trading

Governance

Viewing Open Orders

Order Management Interface

Querying Open Orders

Single Order Query

Order Information Structure

Order Status Tracking

Partial Fills

Order Completion

Order Events

New Order Event

Fill Order Event

Best Practices

Monitor Regularly

Track Performance

Cancelling Orders

Cancel Single Order

Cancel Multiple Orders

Market Depth Analysis

Troubleshooting Orders

API Reference

Query Methods

Order Management Methods

Next Steps

Order Matching

Place Orders

​Viewing Open Orders

​Order Management Interface

​Querying Open Orders

​Single Order Query

​Order Information Structure

​Order Status Tracking

​Partial Fills

​Order Completion

​Order Events

​New Order Event

​Fill Order Event

​Best Practices

Monitor Regularly

Track Performance

​Cancelling Orders

​Cancel Single Order

​Cancel Multiple Orders

​Market Depth Analysis

​Troubleshooting Orders

​API Reference

​Query Methods

​Order Management Methods

​Next Steps

Order Matching

Place Orders

Viewing Open Orders

Order Management Interface

Querying Open Orders

Single Order Query

Order Information Structure

Order Status Tracking

Partial Fills

Order Completion

Order Events

New Order Event

Fill Order Event

Best Practices

Cancelling Orders

Cancel Single Order

Cancel Multiple Orders

Market Depth Analysis

Troubleshooting Orders

API Reference

Query Methods

Order Management Methods

Next Steps