> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whitebit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create collateral OCO order

> Create a collateral OCO (one-cancels-the-other) order combining limit and stop-limit via the V4 API.

export const RegionalRestrictionNote = () => <Note>
    Available order types and execution flags depend on your region. A request
    for an order type or flag not available in your region is rejected with HTTP
    status <code>453</code>. See all details in{' '}
    <a href="/concepts/order-types#regional-restrictions">
      Order types — Regional restrictions
    </a>
    .
  </Note>;

export const signerFields = [{
  "name": "market",
  "type": "string",
  "required": true,
  "description": "Available margin market. Example: BTC_USDT",
  "example": "BTC_USDT"
}, {
  "name": "side",
  "type": "string",
  "required": true,
  "description": "Order direction. Use buy to open or increase a long position and sell to open or increase a short position.",
  "example": "buy",
  "enum": ["buy", "sell"]
}, {
  "name": "amount",
  "type": "string",
  "required": true,
  "description": "Amount of stock currency for both legs of the OCO order. Minimum and step values are market-dependent — query the market info endpoint for constraints.",
  "example": "0.001"
}, {
  "name": "price",
  "type": "string",
  "required": true,
  "description": "Limit order price in money currency for the take-profit leg.",
  "example": "40000"
}, {
  "name": "activation_price",
  "type": "string",
  "required": true,
  "description": "Trigger price in money currency for the stop-loss leg. The stop-limit order activates when the market price reaches the specified value.",
  "example": "41000"
}, {
  "name": "stop_limit_price",
  "type": "string",
  "required": true,
  "description": "Execution price in money currency for the stop-loss leg. After activation, the stop-loss leg places a limit order at the specified price.",
  "example": "42000"
}, {
  "name": "clientOrderId",
  "type": "string",
  "required": false,
  "description": "Custom client order identifier. Uniqueness is enforced only among the account's open (pending) orders on the same market — once a previous order is filled or canceled, the same …",
  "example": "order1987111"
}, {
  "name": "reduceOnly",
  "type": "boolean",
  "required": false,
  "description": "When true, both legs of the OCO order can only reduce or close an existing position — neither leg can increase the position or open a new one. If the order amount exceeds the cu…",
  "example": "false",
  "default": false
}, {
  "name": "positionSide",
  "type": "string",
  "required": false,
  "description": "Position direction. Optional at the request layer but functionally required when hedge mode is enabled. See positionSide. Both legs of the OCO inherit the value. - **One-way mod…",
  "example": "LONG",
  "enum": ["LONG", "SHORT", "BOTH"]
}, {
  "name": "stp",
  "type": "string",
  "required": false,
  "description": "Self-trade prevention mode. The value applies to both legs of the OCO order. Allowed values: no (self-trades allowed), cb (cancel both the new and the existing order), cn (cance…",
  "example": "no",
  "enum": ["no", "cb", "cn", "co"],
  "default": "no"
}];

export const WhitebitSigner = ({path: defaultPath = "/api/v4/order/market", defaultParams = "{}", fields = null}) => {
  const {useState, useMemo} = React;
  const [baseUrl, setBaseUrl] = useState("https://whitebit.com");
  const getApiHost = () => baseUrl;
  const hex = buf => Array.from(new Uint8Array(buf)).map(b => b.toString(16).padStart(2, "0")).join("");
  const b64 = s => {
    const bytes = new TextEncoder().encode(s);
    let bin = "";
    bytes.forEach(b => bin += String.fromCharCode(b));
    return btoa(bin);
  };
  const hmacSha512Hex = async (secret, msg) => {
    const key = await crypto.subtle.importKey("raw", new TextEncoder().encode(secret), {
      name: "HMAC",
      hash: "SHA-512"
    }, false, ["sign"]);
    const sig = await crypto.subtle.sign("HMAC", key, new TextEncoder().encode(msg));
    return hex(sig);
  };
  const queryFields = fields ? fields.filter(function (f) {
    return f.paramIn === "query" || f.paramIn === "path";
  }) : [];
  const bodyFields = fields ? fields.filter(function (f) {
    return !f.paramIn || f.paramIn === "body";
  }) : [];
  const [open, setOpen] = useState(false);
  const [authOpen, setAuthOpen] = useState(true);
  const [paramsOpen, setParamsOpen] = useState(true);
  const [apiKey, setApiKey] = useState("");
  const [apiSecret, setApiSecret] = useState("");
  const [showSecret, setShowSecret] = useState(false);
  const [path, setPath] = useState(defaultPath);
  const initFieldValues = fieldDefs => {
    if (!fieldDefs) return {};
    const vals = {};
    for (const f of fieldDefs) {
      vals[f.name] = f.default !== undefined ? String(f.default) : "";
    }
    return vals;
  };
  const [fieldValues, setFieldValues] = useState(function () {
    return initFieldValues(fields);
  });
  const [showRaw, setShowRaw] = useState(false);
  const [params, setParams] = useState(defaultParams === "{}" ? "" : defaultParams);
  const [computed, setComputed] = useState(null);
  const [response, setResponse] = useState(null);
  const [busy, setBusy] = useState(false);
  const [error, setError] = useState("");
  const [urlCopied, setUrlCopied] = useState(false);
  const useFieldsMode = fields !== null && fields !== undefined && !showRaw;
  const setFieldValue = (name, value) => setFieldValues(function (prev) {
    return {
      ...prev,
      [name]: value
    };
  });
  const toggleRaw = () => {
    if (fields === null || fields === undefined) return;
    if (!showRaw) {
      const obj = {};
      for (const f of bodyFields) {
        const val = fieldValues[f.name];
        if (val !== "" && val !== null && val !== undefined) {
          obj[f.name] = f.type === "integer" || f.type === "number" ? Number(val) : val;
        }
      }
      setParams(Object.keys(obj).length ? JSON.stringify(obj, null, 2) : "");
      setShowRaw(true);
    } else {
      try {
        const parsed = JSON.parse(params.trim() || "{}");
        const next = {
          ...fieldValues
        };
        for (const f of bodyFields) {
          if (parsed[f.name] !== undefined) next[f.name] = String(parsed[f.name]);
        }
        setFieldValues(next);
      } catch (e) {}
      setShowRaw(false);
    }
  };
  const compute = async () => {
    setError("");
    setComputed(null);
    setResponse(null);
    try {
      if (!apiKey.trim()) throw new Error("API key is required");
      if (!apiSecret.trim()) throw new Error("API secret is required");
      let extraBodyParams = {};
      let queryString = "";
      if (useFieldsMode) {
        const qParams = {};
        for (const f of fields) {
          const val = fieldValues[f.name];
          const empty = val === "" || val === null || val === undefined;
          if (empty) {
            if (f.required) throw new Error('"' + f.name + '" is required');
            continue;
          }
          if (f.paramIn === "query" || f.paramIn === "path") {
            qParams[f.name] = String(val);
          } else {
            if (f.type === "integer" || f.type === "number") {
              const num = Number(val);
              if (isNaN(num)) throw new Error('"' + f.name + '" must be a number');
              extraBodyParams[f.name] = num;
            } else {
              extraBodyParams[f.name] = val;
            }
          }
        }
        if (Object.keys(qParams).length > 0) {
          queryString = "?" + Object.entries(qParams).map(function (kv) {
            return encodeURIComponent(kv[0]) + "=" + encodeURIComponent(kv[1]);
          }).join("&");
        }
      } else if (params.trim()) {
        try {
          extraBodyParams = JSON.parse(params.trim());
        } catch (e) {
          throw new Error("Body params is not valid JSON");
        }
      }
      const bodyObj = {
        request: path,
        nonce: Date.now(),
        nonceWindow: true
      };
      for (const k in extraBodyParams) bodyObj[k] = extraBodyParams[k];
      const bodyStr = JSON.stringify(bodyObj);
      const payload = b64(bodyStr);
      const signature = await hmacSha512Hex(apiSecret.trim(), payload);
      const result = {
        payload,
        signature,
        bodyStr,
        queryString
      };
      setComputed(result);
      return result;
    } catch (e) {
      setError(e && e.message ? e.message : String(e));
      return null;
    }
  };
  const send = async () => {
    setBusy(true);
    setResponse(null);
    try {
      const out = await compute();
      if (!out) return;
      const res = await fetch("/_mintlify/api/request", {
        method: "POST",
        headers: {
          "Content-Type": "application/json"
        },
        body: JSON.stringify({
          method: "post",
          url: getApiHost() + path + out.queryString,
          header: {
            "content-type": "application/json",
            "X-TXC-APIKEY": apiKey.trim(),
            "X-TXC-PAYLOAD": out.payload,
            "X-TXC-SIGNATURE": out.signature
          },
          body: JSON.parse(out.bodyStr),
          cookie: {},
          query: {}
        })
      });
      const text = await res.text();
      let status = res.status;
      let pretty = text;
      try {
        const json = JSON.parse(text);
        if (json.statusCode !== undefined) {
          status = json.statusCode;
          const raw = typeof json.body === "string" ? json.body : JSON.stringify(json.body);
          try {
            pretty = JSON.stringify(JSON.parse(raw), null, 2);
          } catch (e2) {
            pretty = raw;
          }
        } else {
          pretty = JSON.stringify(json, null, 2);
        }
      } catch (e2) {}
      setResponse({
        status,
        body: pretty
      });
    } catch (e) {
      setError(e && e.message ? e.message : String(e));
    } finally {
      setBusy(false);
    }
  };
  const copy = text => {
    if (navigator && navigator.clipboard) navigator.clipboard.writeText(text);
  };
  const headerRows = useMemo(function () {
    if (!computed) return [];
    return [{
      key: "X-TXC-APIKEY",
      value: apiKey.trim()
    }, {
      key: "X-TXC-PAYLOAD",
      value: computed.payload
    }, {
      key: "X-TXC-SIGNATURE",
      value: computed.signature
    }];
  }, [computed, apiKey]);
  const INPUT_CLS = "w-full rounded-xl border-standard px-3 py-2 text-sm font-mono bg-background-light dark:bg-background-dark outline-none focus:ring-1 focus:ring-[#3064E3]/40 text-gray-900 dark:text-gray-100 placeholder-gray-400 dark:placeholder-white/20";
  const SECTION_CLS = "rounded-2xl border border-zinc-200 dark:border-zinc-800";
  const SECTION_BTN_CLS_OPEN = "flex w-full pt-3.5 pb-3 px-3.5 items-center justify-between cursor-pointer hover:bg-gray-50 dark:hover:bg-white/5 transition-colors rounded-t-2xl";
  const SECTION_BTN_CLS_CLOSED = "flex w-full pt-3.5 pb-3 px-3.5 items-center justify-between cursor-pointer hover:bg-gray-50 dark:hover:bg-white/5 transition-colors rounded-2xl";
  const renderField = function (f) {
    return <div key={f.name}>
        <div className="flex items-center gap-1.5 mb-1 mt-2.5">
          <span className="text-xs font-mono font-medium text-gray-700 dark:text-gray-300">{f.name}</span>
          {f.required ? <span className="text-xs text-red-500 dark:text-red-400">required</span> : <span className="text-xs text-gray-400 dark:text-gray-500">optional</span>}
          <span className="text-xs text-gray-400 dark:text-gray-500 ml-auto">{f.type}{f.enum ? " · enum" : ""}</span>
        </div>
        {f.description && <div className="text-xs text-gray-400 dark:text-gray-500 mb-1">{f.description}</div>}
        {f.enum ? <select className={INPUT_CLS} value={fieldValues[f.name] || ""} onChange={function (e) {
      setFieldValue(f.name, e.target.value);
    }}>
            {!f.required && <option value="">— leave empty —</option>}
            {f.enum.map(function (v) {
      return <option key={v} value={v}>{v}</option>;
    })}
          </select> : <input type={f.type === "integer" || f.type === "number" ? "number" : "text"} className={INPUT_CLS} value={fieldValues[f.name] || ""} onChange={function (e) {
      setFieldValue(f.name, e.target.value);
    }} placeholder={f.example !== undefined ? String(f.example) : f.required ? f.name : "optional"} spellCheck={false} autoComplete="off" />}
      </div>;
  };
  return <div className="not-prose my-6 flex w-full flex-col bg-background-light dark:bg-background-dark border-standard rounded-2xl p-1.5">

      {}
      <div className="flex w-full items-center space-x-1.5 rounded-xl p-1.5 border-standard">

        {}
        <div className="flex items-center gap-1.5 flex-1 min-w-0">
          <span className="rounded-lg font-bold px-1.5 py-0.5 text-xs leading-5 shrink-0 bg-blue-400/20 text-blue-700 dark:text-blue-400">
            POST
          </span>
          <div className="flex items-center flex-1 min-w-0 text-sm font-mono overflow-hidden">
            {}
            <div className="relative shrink-0 flex items-center">
              <select value={baseUrl} onChange={function (e) {
    setBaseUrl(e.target.value);
  }} onClick={function (e) {
    e.stopPropagation();
  }} className="appearance-none bg-transparent outline-none font-mono text-sm text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-gray-200 transition-colors cursor-pointer pr-4">
                <option value="https://whitebit.com">https://whitebit.com</option>
                <option value="https://whitebit.eu">https://whitebit.eu</option>
              </select>
              <svg className="absolute right-0 top-1/2 -translate-y-1/2 pointer-events-none text-gray-400 dark:text-gray-500" width="10" height="10" viewBox="0 0 10 10" fill="none">
                <path d="M2 3.5L5 6.5L8 3.5" stroke="currentColor" strokeWidth="1.2" strokeLinecap="round" strokeLinejoin="round" />
              </svg>
            </div>
            {}
            <button type="button" title="Copy URL" onClick={function () {
    var url = baseUrl + path;
    if (navigator && navigator.clipboard) navigator.clipboard.writeText(url);
    setUrlCopied(true);
    setTimeout(function () {
      setUrlCopied(false);
    }, 1500);
  }} className="truncate text-left text-black dark:text-white transition-colors">
              {path}
            </button>
          </div>
        </div>

        <div className="flex items-center gap-1.5 shrink-0">
          {}
          <button type="button" title="Copy URL" onClick={function () {
    var url = getApiHost() + path;
    if (navigator && navigator.clipboard) navigator.clipboard.writeText(url);
    setUrlCopied(true);
    setTimeout(function () {
      setUrlCopied(false);
    }, 1500);
  }} className="flex items-center justify-center w-6 h-6 rounded-lg hover:bg-gray-200 dark:hover:bg-white/10 text-gray-400 dark:text-gray-500 transition-colors">
            {urlCopied ? <svg width="13" height="13" viewBox="0 0 13 13" fill="none">
                <path d="M2 7L5 10L11 3" stroke="#2AB673" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
              </svg> : <svg width="13" height="13" viewBox="0 0 13 13" fill="none">
                <rect x="4.5" y="1.5" width="7" height="8" rx="1.5" stroke="currentColor" strokeWidth="1.2" />
                <path d="M2 4.5H1.5A1 1 0 0 0 .5 5.5v6A1 1 0 0 0 1.5 12.5h6A1 1 0 0 0 8.5 11.5V11" stroke="currentColor" strokeWidth="1.2" strokeLinecap="round" />
              </svg>}
          </button>

          {}
          <button type="button" onClick={function () {
    setOpen(function (v) {
      return !v;
    });
  }} className="text-sm font-semibold px-3 py-1.5 rounded-lg bg-[#2AB673] text-white hover:bg-[#239660] active:bg-[#1e7d52] transition-colors hidden sm:inline-flex items-center gap-1.5 cursor-pointer">
            {open ? <>
                Close
                <svg width="12" height="12" viewBox="0 0 12 12" fill="none" className="shrink-0">
                  <path d="M2 9L6 5L10 9" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
                </svg>
              </> : <>
                Try it
                <svg width="12" height="12" viewBox="0 0 12 12" fill="none" className="shrink-0">
                  <polygon points="2,1 11,6 2,11" fill="currentColor" />
                </svg>
              </>}
          </button>
        </div>
      </div>

      {}
      {open && <div className="mt-1.5 space-y-1.5">

          {}
          <div className={SECTION_CLS}>
            <button type="button" onClick={function () {
    setAuthOpen(function (v) {
      return !v;
    });
  }} className={authOpen ? SECTION_BTN_CLS_OPEN : SECTION_BTN_CLS_CLOSED}>
              <div className="flex items-center gap-x-1.5">
                <svg width="12" height="12" viewBox="0 0 12 12" fill="none" className="text-gray-400 dark:text-gray-500 transition-transform shrink-0" style={{
    transform: authOpen ? "rotate(90deg)" : "rotate(0deg)"
  }}>
                  <path d="M4 2.5L8 6L4 9.5" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
                </svg>
                <span className="text-sm font-medium text-gray-800 dark:text-gray-200 leading-6">Authentication</span>
              </div>
            </button>
            {authOpen && <div className="px-3.5 pb-3.5 pt-0 border-t border-zinc-100 dark:border-zinc-800/60">
                <div className="flex items-center gap-1.5 mb-1 mt-2.5">
                  <span className="text-xs font-mono font-medium text-gray-700 dark:text-gray-300">X-TXC-APIKEY</span>
                  <span className="text-xs text-red-500 dark:text-red-400">required</span>
                  <span className="text-xs text-gray-400 dark:text-gray-500 ml-auto">string</span>
                </div>
                <input className={INPUT_CLS} value={apiKey} onChange={function (e) {
    setApiKey(e.target.value);
  }} placeholder="your-api-key" autoComplete="off" spellCheck={false} />

                <div className="flex items-center gap-1.5 mb-1 mt-2.5">
                  <span className="text-xs font-mono font-medium text-gray-700 dark:text-gray-300">API secret</span>
                  <span className="text-xs text-red-500 dark:text-red-400">required</span>
                  <span className="text-xs text-gray-400 dark:text-gray-500 ml-auto">string</span>
                </div>
                <div className="flex gap-1.5">
                  <input type={showSecret ? "text" : "password"} className={INPUT_CLS + " flex-1"} value={apiSecret} onChange={function (e) {
    setApiSecret(e.target.value);
  }} placeholder="your-api-secret" autoComplete="off" spellCheck={false} />
                  <button type="button" onClick={function () {
    setShowSecret(function (v) {
      return !v;
    });
  }} className="text-xs px-2.5 rounded-xl border-standard bg-background-light dark:bg-background-dark hover:bg-gray-50 dark:hover:bg-white/5 text-gray-500 dark:text-gray-400 shrink-0 transition-colors">
                    {showSecret ? "hide" : "show"}
                  </button>
                </div>
                <p className="text-xs text-gray-400 dark:text-gray-500 mt-1.5">
                  Credentials stay in memory only — never written to localStorage or cookies.
                </p>
              </div>}
          </div>

          {}
          <div className={SECTION_CLS}>
            <button type="button" onClick={function () {
    setParamsOpen(function (v) {
      return !v;
    });
  }} className={paramsOpen ? SECTION_BTN_CLS_OPEN : SECTION_BTN_CLS_CLOSED}>
              <div className="flex items-center gap-x-1.5">
                <svg width="12" height="12" viewBox="0 0 12 12" fill="none" className="text-gray-400 dark:text-gray-500 transition-transform shrink-0" style={{
    transform: paramsOpen ? "rotate(90deg)" : "rotate(0deg)"
  }}>
                  <path d="M4 2.5L8 6L4 9.5" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
                </svg>
                <span className="text-sm font-medium text-gray-800 dark:text-gray-200 leading-6">Body</span>
              </div>
              {fields !== null && fields !== undefined && bodyFields.length > 0 && <button type="button" onClick={function (e) {
    e.stopPropagation();
    toggleRaw();
  }} className="text-xs text-gray-400 hover:text-gray-600 dark:hover:text-gray-300 underline mr-1">
                  {showRaw ? "form fields" : "edit as JSON"}
                </button>}
            </button>
            {paramsOpen && <div className="px-3.5 pb-3.5 pt-0 border-t border-zinc-100 dark:border-zinc-800/60">
                {queryFields.length > 0 && <div className="mb-1">
                    <p className="text-xs font-medium text-gray-500 dark:text-gray-400 mb-1 mt-2.5">Query parameters</p>
                    {queryFields.map(renderField)}
                  </div>}

                {useFieldsMode ? bodyFields.length > 0 ? <div>
                      {bodyFields.map(renderField)}
                      <p className="text-xs text-gray-400 dark:text-gray-500 mt-2">
                        <code className="font-mono">request</code>, <code className="font-mono">nonce</code>, <code className="font-mono">nonceWindow</code> added automatically.
                      </p>
                    </div> : <p className="text-xs text-gray-400 dark:text-gray-500 mt-2.5">
                      No body parameters required.{" "}
                      <code className="font-mono">request</code>, <code className="font-mono">nonce</code>, <code className="font-mono">nonceWindow</code> added automatically.
                    </p> : <div>
                    <p className="text-xs text-gray-400 dark:text-gray-500 mt-2.5 mb-1.5">
                      <code className="font-mono">request</code>, <code className="font-mono">nonce</code>, <code className="font-mono">nonceWindow</code> added automatically.
                    </p>
                    <textarea className={INPUT_CLS + " min-h-[80px] resize-y"} rows={4} value={params} onChange={function (e) {
    setParams(e.target.value);
  }} placeholder="{ &quot;market&quot;: &quot;BTC_USDT&quot; }" spellCheck={false} />
                  </div>}
              </div>}
          </div>

          {}
          <div className="flex flex-wrap items-center gap-1.5 px-0.5">
            <button type="button" onClick={send} disabled={busy} className="flex items-center justify-center px-3 h-9 text-sm font-medium rounded-xl hover:opacity-80 gap-1.5 transition-opacity disabled:opacity-50 disabled:pointer-events-none bg-[#3064E3] text-white">
              {busy ? <svg className="animate-spin w-4 h-4" viewBox="0 0 24 24" fill="none">
                  <circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" />
                  <path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8v8z" />
                </svg> : "Send request"}
            </button>
            <button type="button" onClick={compute} disabled={busy} className="flex items-center justify-center px-3 h-9 text-sm font-medium rounded-xl border-standard hover:bg-gray-50 dark:hover:bg-white/5 transition-colors disabled:opacity-50 disabled:pointer-events-none text-gray-700 dark:text-gray-300 bg-background-light dark:bg-background-dark">
              Compute headers
            </button>
          </div>

          {}
          {error && <div className="px-3.5 py-2.5 rounded-2xl border border-red-200 dark:border-red-900/40 bg-red-50 dark:bg-red-950/20 text-sm text-red-600 dark:text-red-400 break-words">
              {error}
            </div>}

          {}
          {computed && <div className={SECTION_CLS + " overflow-hidden"}>
              <div className="flex items-center justify-between pt-3 pb-2.5 px-3.5 border-b border-zinc-100 dark:border-zinc-800/60">
                <span className="text-sm font-medium text-gray-800 dark:text-gray-200">Computed headers</span>
              </div>
              <div className="px-3.5 pb-3.5">
                {headerRows.map(function (row) {
    return <div key={row.key} className="mt-2.5">
                      <div className="flex items-center justify-between mb-1">
                        <span className="text-xs font-mono text-gray-500 dark:text-gray-400">{row.key}</span>
                        <button type="button" onClick={function () {
      copy(row.value);
    }} className="text-xs px-2 py-0.5 rounded-lg border-standard hover:bg-gray-50 dark:hover:bg-white/5 text-gray-500 dark:text-gray-400 transition-colors">
                          copy
                        </button>
                      </div>
                      <input readOnly value={row.value} className="w-full rounded-xl border-standard px-3 py-2 text-xs font-mono bg-gray-50 dark:bg-white/[0.03] text-gray-500 dark:text-gray-400 outline-none select-all cursor-default" />
                    </div>;
  })}
                <details className="mt-2.5">
                  <summary className="text-xs text-gray-400 dark:text-gray-500 cursor-pointer select-none hover:text-gray-600 dark:hover:text-gray-300 transition-colors">
                    full request body
                  </summary>
                  <pre className="text-xs font-mono whitespace-pre-wrap break-all mt-2 text-gray-600 dark:text-gray-400 m-0">
                    {(function () {
    try {
      return JSON.stringify(JSON.parse(computed.bodyStr), null, 2);
    } catch (e) {
      return computed.bodyStr;
    }
  })()}
                  </pre>
                </details>
                {computed.queryString && <p className="text-xs text-gray-400 dark:text-gray-500 font-mono mt-1">
                    query: {computed.queryString}
                  </p>}
              </div>
            </div>}

          {}
          {response && <div className={SECTION_CLS + " overflow-hidden"}>
              <div className="flex items-center gap-2 pt-3 pb-2.5 px-3.5 border-b border-zinc-100 dark:border-zinc-800/60">
                <span className="text-sm font-medium text-gray-800 dark:text-gray-200">Response</span>
                <span className={"text-xs font-mono font-medium px-1.5 py-0.5 rounded-lg " + (response.status < 400 ? "bg-[#2AB673]/10 text-[#2AB673]" : "bg-red-100/50 dark:bg-red-400/10 text-red-600 dark:text-red-300")}>
                  {response.status}
                </span>
              </div>
              <pre className="text-xs font-mono whitespace-pre-wrap overflow-auto max-h-80 m-0 px-3.5 py-3 text-gray-700 dark:text-gray-300">
                {response.body}
              </pre>
            </div>}

        </div>}

    </div>;
};

export const RelatedResources = ({children}) => {
  const {useEffect, useRef, useState} = React;
  const ref = useRef(null);
  const [visible, setVisible] = useState(false);
  useEffect(() => {
    if (!ref.current) return;
    const el = ref.current;
    if (el.parentElement) {
      el.parentElement.appendChild(el);
    }
    setVisible(true);
  }, []);
  return <div ref={ref} className="related-resources" style={{
    marginTop: "2.5rem",
    paddingTop: "1.5rem",
    borderTop: "1px solid var(--border-color, #e5e7eb)",
    opacity: visible ? 1 : 0,
    transition: "opacity 0.15s ease-in"
  }}>
      <h2 style={{
    marginTop: 0
  }}>Related resources</h2>
      {children}
    </div>;
};

<WhitebitSigner path="/api/v4/order/collateral/oco" fields={signerFields} />

<RegionalRestrictionNote />

<RelatedResources>
  * [Query unexecuted OCO orders](/api-reference/trading/query-unexecuted-oco-orders) — List active OCO orders
  * [Collateral limit order](/api-reference/trading/collateral-limit-order) — Place a single collateral limit order
  * [Collateral stop-limit order](/api-reference/trading/collateral-stop-limit-order) — Place a collateral stop-limit order
  * [Cancel conditional order](/api-reference/trading/cancel-conditional-order) — Cancel an active conditional order
</RelatedResources>


## OpenAPI

````yaml openapi/private/http-trade-v4.yaml POST /api/v4/order/collateral/oco
openapi: 3.0.3
info:
  title: Private HTTP API V4 - Collateral Trading
  description: |
    WhiteBIT Private HTTP API V4 for collateral/margin trading operations.

    Base URL: https://whitebit.com

    All endpoints return time in Unix-time format.
    All endpoints return either a JSON object or array.
    For receiving responses from API calls please use http method POST.

    Authentication required for all endpoints.
  version: 4.0.0
  license:
    name: WhiteBIT Terms of Service
    url: https://whitebit.com/terms
servers:
  - url: https://whitebit.com
    description: WhiteBIT Global Server
  - url: https://whitebit.eu
    description: WhiteBIT EU Server
security:
  - ApiKeyAuth: []
    PayloadAuth: []
    SignatureAuth: []
tags:
  - name: Collateral Trading
    description: Endpoints for collateral/margin trading operations
  - name: Spot Trading
    description: Endpoints for spot trading operations
  - name: Market Fee
    description: Endpoints for querying trading fees
paths:
  /api/v4/order/collateral/oco:
    post:
      tags:
        - Collateral Trading
      summary: Create collateral OCO order
      description: >
        The endpoint creates a collateral
        [OCO](/glossary#one-cancels-the-other-oco) (one-cancels-the-other) order
        using [collateral balance](/glossary#balance-collateral). An OCO order
        combines a limit order (take-profit leg) and a stop-limit order
        (stop-loss leg) into a single conditional group. When one leg executes,
        the system cancels the other automatically.


        <Warning>

        Rate limit: 10000 requests/10 sec.

        </Warning>


        <Accordion title="Error Codes">
          - `30` - default validation error code. Also returned when `reduceOnly=true` is combined with `stopLoss` or `takeProfit`
          - `31` - market validation failed
          - `32` - amount validation failed
          - `33` - price validation failed
          - `36` - clientOrderId validation failed
          - `10` - insufficient balance to place the order
          - `111` - resulting position would exceed the market maximum
          - `112` - pending orders value would exceed the allowed maximum
          - `113` - position side cannot be changed while open positions or orders exist
          - `114` - hedge mode position side does not match (sent `BOTH` or omitted `positionSide` in hedge mode, or sent `LONG`/`SHORT` in one-way mode)
          - `115` - order would open a position in the opposite direction (one-way mode)
          - `116` - reduce-only validation failed (no position exists or order side matches position direction)
        </Accordion>
      operationId: createCollateralOcoOrder
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - market
                - side
                - amount
                - price
                - activation_price
                - stop_limit_price
                - request
                - nonce
              properties:
                market:
                  type: string
                  description: >-
                    Available margin [market](/glossary#market). Example:
                    BTC_USDT
                  example: BTC_USDT
                side:
                  type: string
                  enum:
                    - buy
                    - sell
                  description: >-
                    Order direction. Use `buy` to open or increase a long
                    position and `sell` to open or increase a short position.
                  example: buy
                amount:
                  type: string
                  description: >-
                    Amount of [stock](/glossary#stock) currency for both legs of
                    the OCO order. Minimum and step values are market-dependent
                    — query the [market
                    info](/api-reference/market-data/market-info) endpoint for
                    constraints.
                  example: '0.001'
                price:
                  type: string
                  description: >-
                    Limit order price in [money](/glossary#money) currency for
                    the take-profit leg.
                  example: '40000'
                activation_price:
                  type: string
                  description: >-
                    Trigger price in [money](/glossary#money) currency for the
                    stop-loss leg. The stop-limit order activates when the
                    market price reaches the specified value.
                  example: '41000'
                stop_limit_price:
                  type: string
                  description: >-
                    Execution price in [money](/glossary#money) currency for the
                    stop-loss leg. After activation, the stop-loss leg places a
                    limit order at the specified price.
                  example: '42000'
                clientOrderId:
                  type: string
                  description: >-
                    Custom client order identifier. Uniqueness is enforced only
                    among the account's open (pending) orders on the same market
                    — once a previous order is filled or canceled, the same
                    identifier can be reused, including on the same market.
                    Contains only letters, numbers, dashes, dots, or
                    underscores.
                  example: order1987111
                reduceOnly:
                  type: boolean
                  default: false
                  description: >-
                    When `true`, both legs of the OCO order can only reduce or
                    close an existing position — neither leg can increase the
                    position or open a new one. If the order amount exceeds the
                    current position size, the system reduces the order to match
                    — the response returns the adjusted amount. The API returns
                    error code `116` if no open position exists or the order
                    side matches the position direction. See
                    [reduce-only](/glossary#reduce-only).
                  example: false
                positionSide:
                  type: string
                  enum:
                    - LONG
                    - SHORT
                    - BOTH
                  description: >
                    Position direction. Optional at the request layer but
                    functionally required when hedge mode is enabled. See
                    [positionSide](/glossary#position-side). Both legs of the
                    OCO inherit the value.


                    - **One-way mode** (default account mode): the field is
                    ignored. Orders always use `BOTH`, and the response returns
                    `positionSide: "BOTH"` on each leg whether the field is sent
                    or omitted.

                    - **Hedge mode**: the field MUST be `LONG` or `SHORT`.
                    Sending `BOTH`, omitting the field, or sending a value that
                    does not match the account's mode causes the trade service
                    to reject the order with error code `114` (`Hedge mode
                    position side does not match`).
                  example: LONG
                stp:
                  type: string
                  enum:
                    - 'no'
                    - cb
                    - cn
                    - co
                  default: 'no'
                  description: >
                    Self-trade prevention mode. The value applies to both legs
                    of the OCO order. Allowed values: `no` (self-trades
                    allowed), `cb` (cancel both the new and the existing order),
                    `cn` (cancel the new order, keep the existing), `co` (cancel
                    the existing order, place the new one). Default: `no`.


                    Legacy values `cancel_both`, `cancel_new`, `cancel_old` are
                    deprecated: the API accepts the legacy values with identical
                    behavior until a deprecation deadline is announced, then
                    rejects the legacy values. Responses always return the
                    abbreviated form, regardless of which variant the request
                    used.


                    See [Self-Trade
                    Prevention](/platform/self-trade-prevention).
                  example: 'no'
                request:
                  type: string
                  example: '{{request}}'
                nonce:
                  type: integer
                  example: 1594297865000
            example:
              market: BTC_USDT
              side: buy
              amount: '0.001'
              price: '40000'
              activation_price: '41000'
              stop_limit_price: '42000'
              clientOrderId: order1987111
              reduceOnly: false
              positionSide: LONG
              request: '{{request}}'
              nonce: 1594297865000
      responses:
        '200':
          description: Successful response - OCO order created
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    description: OCO order identifier
                    example: 117703764513
                  reduceOnly:
                    type: boolean
                    description: Reduce-only flag
                    example: false
                  stop_loss:
                    type: object
                    description: Stop loss order details
                    properties:
                      orderId:
                        type: integer
                        description: Order identifier
                        example: 117703764514
                      clientOrderId:
                        type: string
                        description: Custom order identifier. Empty string if not specified
                        example: ''
                      market:
                        type: string
                        description: Market name
                        example: BTC_USDT
                      side:
                        type: string
                        description: Order side
                        enum:
                          - buy
                          - sell
                        example: buy
                      type:
                        type: string
                        description: Order type
                        example: stop limit
                      timestamp:
                        type: number
                        description: >-
                          Unix timestamp in seconds (UTC) of order creation,
                          with microsecond precision.
                        example: 1594605801.49815
                      dealMoney:
                        type: string
                        description: Executed amount in money
                        example: '0'
                      dealStock:
                        type: string
                        description: Executed amount in stock
                        example: '0'
                      amount:
                        type: string
                        description: Order amount
                        example: '2.241379'
                      takerFee:
                        type: string
                        description: Taker fee ratio
                        example: '0.001'
                      makerFee:
                        type: string
                        description: Maker fee ratio
                        example: '0.001'
                      left:
                        type: string
                        description: Unexecuted amount in stock
                        example: '2.241379'
                      dealFee:
                        type: string
                        description: Executed fee by deal
                        example: '0'
                      post_only:
                        type: boolean
                        description: Post-only flag
                        example: false
                      mtime:
                        type: number
                        description: Timestamp of order modification
                        example: 1662478154.941582
                      price:
                        type: string
                        description: Order price
                        example: '19928.79'
                      activation_price:
                        type: string
                        description: Activation price
                        example: '29928.79'
                      activation_condition:
                        type: string
                        description: >
                          Trigger condition derived from `side` (response-only,
                          cannot be overridden): `buy` → `gte`, `sell` → `lte`.
                        enum:
                          - gte
                          - lte
                        example: gte
                      activated:
                        type: integer
                        description: Activation status (0 - not activated, 1 - activated)
                        example: 0
                      status:
                        $ref: '#/components/schemas/ActiveOrderStatus'
                        type: string
                      stp:
                        type: string
                        description: >-
                          Self-trade prevention mode. Possible values: `no`,
                          `cb`, `cn`, `co`. Always returned in abbreviated form,
                          even when the request used a legacy value.
                        example: 'no'
                      positionSide:
                        type: string
                        description: Position side
                        enum:
                          - LONG
                          - SHORT
                          - BOTH
                        example: LONG
                  take_profit:
                    type: object
                    description: Take profit order details
                    properties:
                      orderId:
                        type: integer
                        description: Order identifier
                        example: 117703764515
                      clientOrderId:
                        type: string
                        description: Custom order identifier. Empty string if not specified
                        example: ''
                      market:
                        type: string
                        description: Market name
                        example: BTC_USDT
                      side:
                        type: string
                        description: Order side
                        enum:
                          - buy
                          - sell
                        example: buy
                      type:
                        type: string
                        description: Order type
                        example: limit
                      timestamp:
                        type: number
                        description: >-
                          Unix timestamp in seconds (UTC) of order creation,
                          with microsecond precision.
                        example: 1662478154.941582
                      dealMoney:
                        type: string
                        description: Executed amount in money
                        example: '0'
                      dealStock:
                        type: string
                        description: Executed amount in stock
                        example: '0'
                      amount:
                        type: string
                        description: Order amount
                        example: '0.635709'
                      takerFee:
                        type: string
                        description: Taker fee ratio
                        example: '0.001'
                      makerFee:
                        type: string
                        description: Maker fee ratio
                        example: '0.001'
                      left:
                        type: string
                        description: Unexecuted amount in stock
                        example: '0.635709'
                      dealFee:
                        type: string
                        description: Executed fee by deal
                        example: '0'
                      post_only:
                        type: boolean
                        description: Post-only flag
                        example: false
                      mtime:
                        type: number
                        description: Timestamp of order modification
                        example: 1662478154.941582
                      price:
                        type: string
                        description: Order price
                        example: '9928.79'
                      status:
                        $ref: '#/components/schemas/ActiveOrderStatus'
                        type: string
                      stp:
                        type: string
                        description: >-
                          Self-trade prevention mode. Possible values: `no`,
                          `cb`, `cn`, `co`. Always returned in abbreviated form,
                          even when the request used a legacy value.
                        example: 'no'
                      positionSide:
                        type: string
                        description: Position side
                        enum:
                          - LONG
                          - SHORT
                          - BOTH
                        example: LONG
              example:
                id: 117703764513
                reduceOnly: false
                stop_loss:
                  orderId: 117703764514
                  clientOrderId: ''
                  market: BTC_USDT
                  side: buy
                  type: stop limit
                  timestamp: 1594605801.49815
                  dealMoney: '0'
                  dealStock: '0'
                  amount: '2.241379'
                  takerFee: '0.001'
                  makerFee: '0.001'
                  left: '2.241379'
                  dealFee: '0'
                  post_only: false
                  mtime: 1662478154.941582
                  price: '19928.79'
                  activation_price: '29928.79'
                  activation_condition: gte
                  activated: 0
                  status: FILLED
                  stp: 'no'
                  positionSide: LONG
                take_profit:
                  orderId: 117703764515
                  clientOrderId: ''
                  market: BTC_USDT
                  side: buy
                  type: limit
                  timestamp: 1662478154.941582
                  dealMoney: '0'
                  dealStock: '0'
                  amount: '0.635709'
                  takerFee: '0.001'
                  makerFee: '0.001'
                  left: '0.635709'
                  dealFee: '0'
                  post_only: false
                  mtime: 1662478154.941582
                  price: '9928.79'
                  status: FILLED
                  stp: 'no'
                  positionSide: LONG
        '400':
          description: Inner validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Request validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service temporarily unavailable
      security:
        - ApiKeyAuth: []
          PayloadAuth: []
          SignatureAuth: []
components:
  schemas:
    ActiveOrderStatus:
      type: string
      description: >-
        Order status. `FILLED` — fully executed. `PARTIALLY_FILLED` — partially
        executed, remainder still active. `CANCELED` — canceled before full
        execution. REST uses the single-`L` spelling `CANCELED`; the double-`L`
        `CANCELLED` and the WebSocket-only `NEW` state are not returned by this
        API.
      enum:
        - FILLED
        - PARTIALLY_FILLED
        - CANCELED
      example: FILLED
    ErrorResponse:
      type: object
      properties:
        code:
          type: integer
          description: Error code
          example: 30
        message:
          type: string
          description: Error message
          example: Validation failed
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Detailed error information
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-TXC-APIKEY
      description: The public WhiteBIT API key.
    PayloadAuth:
      type: apiKey
      in: header
      name: X-TXC-PAYLOAD
      description: Base64-encoded JSON request body.
    SignatureAuth:
      type: apiKey
      in: header
      name: X-TXC-SIGNATURE
      description: >-
        HMAC-SHA512 signature of the payload, hex-encoded. Computed as
        hex(HMAC-SHA512(payload, api_secret)).

````