GET

/api/v1/smart_trades

Izin: SMART_TRADES_READKeamanan: SIGNED

Mengembalikan daftar entitas SmartTrade dengan dukungan paginasi. Gunakan parameter kueri di bawah untuk memfilter, membagi halaman, dan mengurutkan hasil.

Lihat spesifikasi model data dan struktur atribut lengkap pada dokumentasi Entitas SmartTrade.
SmartTrade Entity

Parameter Kueri

12
account_idinteger

Mengembalikan entitas yang terkait dengan akun bursa tertentu. Gunakan endpoint Daftar bursa yang terhubung untuk mendapatkan ID akun.

pairstring

Nama pasangan perdagangan dalam format Quentrade (misal: USDT_BTC, USDT_DOGE).

typestring

Memfilter SmartTrade berdasarkan jenis mode: simple_buy, simple_sell, smart_sell, smart_buy, smart_trade, atau smart_cover.

Allowed type values:
simple_buysimple_sellsmart_sellsmart_buysmart_tradesmart_cover
pageinteger default: 1

Nomor halaman untuk urutan paginasi. Default: 1

per_pageinteger default: 10

Jumlah rekaman data dalam satu halaman. Min: 1, Max: 100, Default: 10

statusstring

Memfilter SmartTrade berdasarkan status siklus hidup. Nilai yang diizinkan: all, active, finished, successfully_finish, cancelled, failed.

Allowed status values:
allactivefinishedsuccessfully_finishcancelledfailed
order_bystring default: status

Bidang acuan pengurutan hasil: created_at, updated_at, closed_at, status, profit, atau profit_percentage. Default: status

Allowed sort fields:
created_atupdated_atclosed_atstatusprofitprofit_percentage
order_directionstring default: DESC

Arah pengurutan: ASC (naik) atau DESC (turun). Default: DESC

fromstring

Parameter string tanggal-waktu ISO 8601 untuk memfilter data yang dibuat pada atau setelah waktu ini.

tostring

Parameter string tanggal-waktu ISO 8601 untuk memfilter data yang dibuat pada atau sebelum waktu ini.

basestring

Simbol ticker mata uang dasar (misal: BTC, ETH, DOGE).

quotestring

Simbol ticker mata uang kuotasi (misal: USDT, USD, BTC).

Parameter Respons

Jika berhasil, respons berisi larik (array) dari objek entitas SmartTrade yang sesuai dengan kriteria filter.

Contoh Permintaan

GET/api/v1/smart_trades?type=smart_trade&order_by=status&from=2022-01-01T00:00:00.000Z&to=2023-01-01T00:00:00.000Z

Contoh Respons

Mengembalikan HTTP 200 OK dengan larik objek SmartTrade.

get_list_of_smart_trades_200.json
200 OK
[
  {
    "id": 28934742,
    "version": 2,
    "account": {
      "id": 32435557,
      "type": "kucoin",
      "name": "My Kucoin",
      "market": "Kucoin Spot",
      "link": "/accounts/32435557"
    },
    "pair": "USDT_DOGE",
    "instant": false,
    "status": {
      "type": "failed",
      "basic_type": "failed",
      "title": "Failed",
      "error": "You need to pass KYC on the exchange to trade on this pair"
    },
    "leverage": {
      "enabled": false
    },
    "position": {
      "type": "buy",
      "editable": false,
      "units": {
        "value": "10.0",
        "editable": false
      },
      "price": {
        "value": "0.1038",
        "value_without_commission": "0.1038",
        "editable": true
      },
      "total": {
        "value": "1.7542"
      },
      "order_type": "market",
      "status": {
        "type": "failed",
        "basic_type": "failed",
        "title": "Failed",
        "error": "You need to pass KYC on the exchange to trade on this pair"
      }
    },
    "take_profit": {
      "enabled": true,
      "price_type": "value",
      "steps": []
    },
    "stop_loss": {
      "enabled": false
    },
    "reduce_funds": {
      "steps": []
    },
    "market_close": {},
    "note": "",
    "note_raw": null,
    "skip_enter_step": false,
    "data": {
      "editable": false,
      "current_price": {
        "bid": "0.10379",
        "ask": "0.1038",
        "last": "0.10379",
        "quote_volume": "4062766.6804568596516",
        "day_change_percent": "1.2"
      },
      "target_price_type": "price",
      "orderbook_price_currency": "USDT",
      "base_order_finished": true,
      "missing_funds_to_close": "0.0",
      "liquidation_price": null,
      "average_enter_price": null,
      "average_close_price": null,
      "average_enter_price_without_commission": null,
      "average_close_price_without_commission": null,
      "panic_sell_available": false,
      "add_funds_available": false,
      "reduce_funds_available": false,
      "force_start_available": false,
      "force_process_available": false,
      "cancel_available": false,
      "finished": false,
      "base_position_step_finished": true,
      "entered_amount": "0.0",
      "entered_total": "0.0",
      "closed_amount": "0.0",
      "closed_total": "0.0",
      "commission": 0.001,
      "created_at": "2024-04-05T02:53:32.225Z",
      "updated_at": "2024-04-05T02:54:39.074Z",
      "closed_at": "2024-04-05T02:54:39.045Z",
      "type": "smart_trade"
    },
    "profit": {
      "volume": null,
      "usd": null,
      "percent": "0.0",
      "roe": null
    },
    "margin": {
      "amount": null,
      "total": null
    },
    "is_position_not_filled": true
  }
]