GET

/api/v1/terminal/history

Izin: SMART_TRADES_READKeamanan: SIGNED

Mengembalikan daftar perdagangan dari riwayat (selesai, dibatalkan, atau ditutup). Endpoint ini mengembalikan perdagangan yang telah selesai, dibatalkan, atau ditutup. Untuk perdagangan yang sedang aktif, gunakan GET /quentrade/trades.

Lihat Entitas Perdagangan untuk definisi atribut lengkap
Trade Entity

Parameter Query

6
account_idinteger

Filter opsional untuk perdagangan pada akun bursa tertentu. Ambil ID akun yang tersedia melalui GET /api/v1/accounts.

pairstring

Filter opsional untuk perdagangan pada pasangan perdagangan tertentu (misal: USDT_BTC, BTC_ETH).

order_bystring
default: created_at

Bidang untuk mengurutkan hasil. Nilai yang diizinkan: pair, created_at, closed_at.

order_directionstring
default: asc

Arah pengurutan: asc (naik) atau desc (turun).

limitinteger
default: 10

Jumlah catatan yang dikembalikan per halaman.

offsetinteger
default: 0

Jumlah catatan yang dilewati untuk penomoran halaman (paginasi).

Contoh Permintaan

GETGET /api/v1/terminal/history?account_id=1&limit=5

Contoh Respons

Mengembalikan larik (array) entitas riwayat perdagangan. Lihat Entitas Perdagangan untuk definisi atribut lengkap.

trades_history_200.json
200 OK
{
  "trades": [
    {
      "uuid": "be523b7b-05a0-49b9-89f9-41ae19fff415",
      "account_id": 32576869,
      "pair": "BTC_ETH",
      "created_at": 1727871936,
      "closed_at": 1727871937,
      "order": {
        "type": "market",
        "side": "buy",
        "strategy": null,
        "position_side": "both",
        "reduce_only": false
      },
      "units": {
        "value": "2.4869"
      },
      "price": {
        "value": null
      },
      "total": {
        "value": "0.099898773"
      },
      "conditional": {
        "enabled": false,
        "value": null,
        "price": {
          "value": null,
          "type": null
        }
      },
      "trailing": {
        "enabled": false,
        "value": null,
        "percent": null
      },
      "timeout": {
        "enabled": false,
        "value": null
      },
      "leverage": {
        "type": null
      },
      "status": {
        "value": "finished",
        "error": null
      },
      "filled": {
        "units": "2.4869",
        "total": "0.099998671773",
        "price": "0.04021",
        "value": "100.0"
      },
      "data": {
        "cancelable": false
      }
    }
  ]
}