Limit Orders

VeTrade publishes a machine-native limit-order planning and read surface for VeChain.

Use this surface when an agent needs to:

• prepare a limit-order creation bundle
• list a maker address limit orders with filters and pagination
• prepare a cancellation bundle
• read on-chain order status

Endpoints

• POST https://vetrade.vet/v2/limit-order-plans
• GET https://vetrade.vet/v2/limit-order-plans
• GET https://vetrade.vet/v2/limit-orders?maker=0x...&status=ACTIVE&page=1&pageSize=20
• GET https://vetrade.vet/v2/limit-orders/{orderId}
• OpenAPI JSON: https://vetrade.vet/openapi/limit-orders-v2.json

Create a limit order

Provide:

• action
• maker
• inputToken
• outputToken
• amountIn
• exactly one of targetPrice or minAmountOut

If inputToken is native VET, VeTrade prepares the wrap-to-vVET flow and sets the vvet:unwrap order option.

Cancel a limit order

Provide:

• action
• maker
• orderId

unwrapVvetOnCancel is optional and defaults to true.

If the order was created with the vvet:unwrap option and the maker wallet still holds matching vVET, VeTrade prepends a local unwrap clause before the cancel clause.

List limit orders

Filters:

• maker is required
• status can be ACTIVE, OPEN, PARTIALLY_FILLED, FILLED, or CANCELLED
• tokenFrom is optional
• tokenTo is optional
• page is 1-based
• pageSize max is 100

Source selection:

• active orders without pair filters prefer on-chain reads
• filtered or historical reads use the indexed VeTrade API fallback

The response includes source so agents can tell whether the result came from on_chain or api.

Plain HTTP examples

curl -X POST https://vetrade.vet/v2/limit-order-plans \

  -H 'Content-Type: application/json' \

  -d '{

    "action": "create",

    "maker": "0x1111111111111111111111111111111111111111",

    "inputToken": "0x0000000000000000000000000000000000000000",

    "outputToken": "0x5ef79995fe8a89e0812330e4378eb2660cede699",

    "amountIn": "1000000000000000000",

    "targetPrice": "1.25"

  }'

curl -X GET 'https://vetrade.vet/v2/limit-orders?maker=0x1111111111111111111111111111111111111111&status=ACTIVE&page=1&pageSize=20'

OpenAI remote MCP example

{

  "server_label": "VeTrade Swap Planner",

  "server_url": "https://mcp.vetrade.vet"

}

ChatGPT developer-mode setup

Remote MCP URL: https://mcp.vetrade.vet

Anthropic / Claude remote MCP setup

Transport: Streamable HTTP

URL: https://mcp.vetrade.vet

Codex skill usage

Use the VeTrade Swap Planner skill when you need VeChain swaps, VeChain trading routes, or VeChain limit-order preparation and status reads.

Safety boundary

• VeTrade can prepare and read limit orders.
• VeTrade does not sign or submit them.
• Use local VeChain execution tooling to sign returned rawClauses.