Build order transaction

Build a new order transaction. This endpoint creates an unsigned transaction that must be signed and submitted via the Submit Order Transaction endpoint.

Build place order transaction

post

Build place order transaction

Body

base_quantitystringOptional

max_slippage_basis_pointstringOptional

post_onlybooleanOptional

LimitSlippage bool json:"limit_slippage"

pricestringOptional

quote_quantitystringOptional

Quantity float64 json:"quantity" binding:"required"

sidestring · enumRequiredPossible values:

symbolstringRequired

typestring · enumRequiredPossible values:

Responses

200

application/json

order_idstringOptionalExample: 550e8400-e29b-41d4-a716-446655440000

tx_hexstringOptionalExample: 84a400818258203b40265111d8bb3c3c608d95b3a0bf83461ace32d79336579a1939b3aad1c0b700018182583900...

400

Bad Request

application/json

406

Not Acceptable

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post

/orders/build

POST /orders/build HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 159

{
  "base_quantity": "text",
  "max_slippage_basis_point": "text",
  "post_only": true,
  "price": "text",
  "quote_quantity": "text",
  "side": "buy",
  "symbol": "text",
  "type": "market"
}

{
  "order_id": "550e8400-e29b-41d4-a716-446655440000",
  "tx_hex": "84a400818258203b40265111d8bb3c3c608d95b3a0bf83461ace32d79336579a1939b3aad1c0b700018182583900..."
}

Request Parameters

Parameter

Type

Required

Description

symbol

string

Yes

Trading pair symbol (e.g., ADAUSDM)

side

string

Yes

Order side: buy or sell

type

string

Yes

Order type: limit or market

base_quantity

string

Conditional

Quantity in base asset (e.g., ADA). Use either base_quantity OR quote_quantity, not both.

quote_quantity

string

Conditional

Quantity in quote asset (e.g., USDM). Use either base_quantity OR quote_quantity, not both.

price

string

Conditional

Order price. Required for limit orders, ignored for market orders.

max_slippage_basis_point

string

Maximum slippage in basis points. Only applicable for market orders.

post_only

boolean

If true, order only posts if it doesn't match immediately. Only applicable for limit orders.

Order Types

Limit Order

A limit order is placed at a specific price. It will only execute at that price or better.

Required parameters:

symbol, side, type (set to limit)
price - The limit price
Either base_quantity or quote_quantity

Optional parameters:

post_only - Set to true to ensure the order only acts as a maker (adds liquidity). If it would match immediately, the order is rejected.

Market Order

A market order executes immediately at the best available price. No price is specified.

Required parameters:

symbol, side, type (set to market)
Either base_quantity or quote_quantity

Optional parameters:

max_slippage_basis_point - Maximum acceptable slippage (1 basis point = 0.01%). If not set, unlimited slippage is allowed.

Market Order Slippage: If max_slippage_basis_point is not set, the market order will fill at any price until the order is complete or your balance is exhausted. Set a slippage limit to protect against unfavorable fills.

Quantity Specification

You must specify either base_quantity or quote_quantity, but not both.

Field

Description

Example

base_quantity

Amount of base asset (e.g., ADA)

"100" = 100 ADA

quote_quantity

Amount of quote asset (e.g., USDM)

"93" = 93 USDM

Example for ADAUSDM pair:

Buy 100 ADA: {"base_quantity": "100", "side": "buy", ...}
Buy $93 worth of ADA: {"quote_quantity": "93", "side": "buy", ...}

Code Examples

Limit Order Example

curl --location 'https://api.deltadefi.io/order/build' \
--header 'X-API-KEY: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
    "symbol": "ADAUSDM",
    "side": "buy",
    "type": "limit",
    "base_quantity": "100",
    "price": "0.93"
}'

const axios = require('axios');
let data = JSON.stringify({
  "symbol": "ADAUSDM",
  "side": "buy",
  "type": "limit",
  "base_quantity": "100",
  "price": "0.93"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.deltadefi.io/order/build',
  headers: { 
    'X-API-KEY': '<your_api_key>', 
    'Content-Type': 'application/json'
  },
  data: data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {
  url := "https://api.deltadefi.io/order/build"
  method := "POST"

  payload := strings.NewReader(`{
    "symbol": "ADAUSDM",
    "side": "buy",
    "type": "limit",
    "base_quantity": "100",
    "price": "0.93"
}`)

  client := &http.Client{}
  req, err := http.NewRequest(method, url, payload)
  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("X-API-KEY", "<your_api_key>")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Market Order Example

curl --location 'https://api.deltadefi.io/order/build' \
--header 'X-API-KEY: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
    "symbol": "ADAUSDM",
    "side": "buy",
    "type": "market",
    "base_quantity": "100",
    "max_slippage_basis_point": "100"
}'

const axios = require('axios');
let data = JSON.stringify({
  "symbol": "ADAUSDM",
  "side": "buy",
  "type": "market",
  "base_quantity": "100",
  "max_slippage_basis_point": "100"  // 1% max slippage
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.deltadefi.io/order/build',
  headers: { 
    'X-API-KEY': '<your_api_key>', 
    'Content-Type': 'application/json'
  },
  data: data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {
  url := "https://api.deltadefi.io/order/build"
  method := "POST"

  payload := strings.NewReader(`{
    "symbol": "ADAUSDM",
    "side": "buy",
    "type": "market",
    "base_quantity": "100",
    "max_slippage_basis_point": "100"
}`)

  client := &http.Client{}
  req, err := http.NewRequest(method, url, payload)
  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("X-API-KEY", "<your_api_key>")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Post-Only Limit Order Example

curl --location 'https://api.deltadefi.io/order/build' \
--header 'X-API-KEY: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
    "symbol": "ADAUSDM",
    "side": "buy",
    "type": "limit",
    "base_quantity": "100",
    "price": "0.90",
    "post_only": true
}'

Response

{
  "order_id": "550e8400-e29b-41d4-a716-446655440000",
  "tx_hex": "84a400818258203b40265111d8bb3c3c608d95b3a0bf83461ace32d79336579a1939b3aad1c0b700018182583900..."
}

Field

Type

Description

order_id

string

Unique order identifier. Use this when submitting the signed transaction.

tx_hex

string

Unsigned transaction hex. Sign this and submit via Submit Order Transaction.

Next Steps

After building the order:

Sign the transaction using your wallet - see How to sign a Cardano transaction
Submit the signed transaction via Submit Order Transaction

Error Codes

Code

Error

Description

4050

Insufficient balance

Not enough free balance to place the order

4100

Order size too small

Order must be at least 5 ADA equivalent

4101

Invalid order price

Price must be greater than 0

4102

Invalid price decimal places

Price has too many decimal places

4103

Invalid quantity decimal places

Quantity has too many decimal places

4104

Post-only would match

Post-only order would match immediately (rejected)

4106

Invalid symbol

Trading pair not found

4109

Insufficient liquidity

Not enough liquidity for market order

4110

Max open orders exceeded

Too many open orders

PreviousOrder NextSubmit order Transaction

Last updated 1 month ago

hashtagBuild place order transaction

hashtagRequest Parameters

hashtagOrder Types

hashtagLimit Order

hashtagMarket Order

hashtagQuantity Specification

hashtagCode Examples

hashtagLimit Order Example

hashtagMarket Order Example

hashtagPost-Only Limit Order Example

hashtagResponse

hashtagNext Steps

hashtagError Codes

hashtagRelated

Build place order transaction

Request Parameters

Order Types

Limit Order

Market Order

Quantity Specification

Code Examples

Limit Order Example

Market Order Example

Post-Only Limit Order Example

Response

Next Steps

Error Codes

Related