POST

/api/v1/terminal/order

Izin: SMART_TRADES_WRITEKeamanan: SIGNED

Membuat perdagangan baru. Endpoint ini mendukung pembuatan pesanan pasar (market) dan limit, termasuk pemicu kondisional opsional, trailing stop, batas waktu (timeout), dan pengaturan leverage (khusus OKX Futures).

Parameter Permintaan

account_idinteger required

ID akun bursa. Gunakan GET /api/v1/accounts untuk mengambil akun yang tersedia.

pairstring required

Pasangan perdagangan dalam format seperti USDT_BTC atau BTC_ETH.

orderobject required

Detail pesanan perdagangan.

unitsobject required

Jumlah untuk dibeli atau dijual dalam unit mata uang dasar.

priceobject

Pengaturan harga, wajib untuk pesanan limit.

conditionalobject required

Konfigurasi pesanan kondisional opsional.

trailingobject required

Konfigurasi trailing stop opsional.

timeoutobject required

Batas waktu (timeout) opsional untuk perdagangan kondisional.

leverageobject

Konfigurasi leverage opsional (khusus OKX Futures).

Contoh Tipe Perdagangan

create_trade_market_buy.json

POST /quentrade/trades

{
  "account_id": 1,
  "pair": "USDT_BTC",
  "order": {
    "type": "market",
    "side": "buy"
  },
  "units": {
    "value": "1.0"
  },
  "conditional": {
    "enabled": false
  },
  "trailing": {
    "enabled": false
  },
  "timeout": {
    "enabled": false
  }
}

Contoh Respons

Jika berhasil, respons menyertakan ID perdagangan, status saat ini, dan metadata eksekusi.

create_trade_201.json

201 Created

{
  "trade": {
    "uuid": "a6f1c3d2-9d1a-4db7-9ad4-f7a8e2f98765",
    "account_id": 1,
    "pair": "USDT_BTC",
    "order": {
      "type": "market",
      "side": "buy"
    },
    "units": {
      "value": "1.0"
    },
    "status": {
      "value": "to_process",
      "error": null
    },
    "filled": {
      "units": "0.0",
      "total": "0.0",
      "price": null
    },
    "created_at": 1727871936,
    "closed_at": null,
    "price": {
      "value": null
    },
    "conditional": {
      "enabled": false,
      "value": null,
      "price": {
        "value": null,
        "type": null
      }
    },
    "trailing": {
      "enabled": false,
      "value": null,
      "percent": null
    },
    "timeout": {
      "enabled": false,
      "value": null
    }
  }
}

SEBELUMNYA Entitas Perdagangan SELANJUTNYADapatkan Perdagangan