POST /v1/orders/validate
Spustí kontroly zadání pokynu nad stejným tělem požadavku, aniž by pokyn zadal.
Podepsaný požadavek s oprávněním trade
trade a podpis požadavku. Postup je na stránce Podpis požadavků, oprávnění vysvětluje Oprávnění a životnost klíče.Tělo požadavku
application/json · PlaceOrderBodyPodepište a odešlete bajt po bajtu totéž tělo, bez přeformátování. Neznámá pole API ignoruje a pole s hodnotou null je totéž jako pole vynechané.
| Pole | Popis |
|---|---|
| symbolpovinnéstring | Symbol trhu z GET /v1/markets, například BTCEUR nebo BTCCZK; velikost písmen nerozhoduje. |
| sidepovinnéstring | buy nebo sell z pohledu základní měny trhu. Jen malými písmeny. Hodnoty: buy, sell. |
| typepovinnéstring | market nebo limit. Jen malými písmeny. Hodnoty: market, limit. |
| quantityvolitelnéstring | Množství v základní měně jako desetinný řetězec s tečkou, například "0.01": kolik získáte při nákupu, kolik prodáte při prodeji. Zadejte quantity, nebo quoteQuantity, nikdy obojí. |
| quoteQuantityvolitelnéstring | Částka v kotovací měně jako desetinný řetězec s tečkou: kolik utratíte při nákupu, kolik získáte při prodeji. Zadejte quantity, nebo quoteQuantity, nikdy obojí. |
| pricevolitelnéstring | Limitní cena v kotovací měně za jednotku základní měny jako desetinný řetězec. Povinná u limitního pokynu, u tržního zakázaná; u trhů v CZK je v CZK. |
| clientOrderIdvolitelnéstring | Váš vlastní identifikátor pokynu, 1 až 64 písmen, číslic, spojovníků a podtržítek, jedinečný pro klíč. Zopakovaný požadavek se stejným clientOrderId vrátí existující pokyn místo zadání druhého. Důrazně doporučeno. |
Odpověď
200 · application/json · ValidateOrderResponseNic se nerezervuje, pokyn nevznikne a ověření se nezapočítává do limitu zadaných pokynů, jen do obecného limitu požadavků.
Pokyn, který by prošel, dostane valid true a v poli estimate nezávazný odhad pokynu se stejnými čísly, jaká ukazuje obchodní formulář v aplikaci: částku, kterou získáte nebo zaplatíte, cenu včetně poplatku Coinera, odhad poplatku a kurz u trhů v CZK. Každá částka je odhad, ne závazná nabídka: pokyn se vypořádá za cenu v okamžiku zadání.
U prodeje s quoteQuantity formulář ukazuje množství k prodeji bez poplatku, proto je estimatedSpent v odhadu null a poplatek je uvedený zvlášť.
Pokyn, který by zadání odmítlo, dostane také odpověď 200, ale s valid false a kódem, popisem a doplňkovými poli, jaké by vrátilo zadání (například BELOW_MINIMUM s minimum nebo INSUFFICIENT_BALANCE s available).
Úspěšné ověření nic nezaručuje: cena, zůstatek i trh se mohou do zadání změnit a několik pojistek se vyhodnotí až při zápisu pokynu.
Ověření je volitelné: pokyn můžete zadat rovnou přes POST /v1/orders.
Odpověď se neukládá do cache.
Částky a ceny jsou desetinné řetězce, aby nedocházelo ke ztrátě přesnosti.
| Pole | Popis |
|---|---|
| validboolean | True, když by zadání pokynu s tímto tělem teď bylo přijato. |
| estimateOrderEstimateResponse nebo null | Nezávazný odhad pokynu se stejnými čísly, jaká ukazuje obchodní formulář v aplikaci Coinero, nebo null, když je valid false. Pole je v odpovědi vždy. |
| estimate.symbolstring | Symbol trhu tak, jak byl požadován, například BTCCZK. |
| estimate.basestring | Kód základní měny, například BTC. |
| estimate.quotestring | Kód kotovací měny, například CZK. |
| estimate.sidestring | Strana odhadovaného pokynu, jak byla požadována. Hodnoty: buy, sell. |
| estimate.typestring | Typ odhadovaného pokynu, jak byl požadován. Hodnoty: market, limit. |
| estimate.quantitystring nebo null | Množství v základní měně jako desetinný řetězec. Když jste zadali quantity, je to toto množství zaokrouhlené na přesnost množství trhu (u nákupu nahoru, u prodeje dolů). Když jste zadali quoteQuantity, je to odhad z obchodního formuláře: při nákupu kolik získáte po poplatku Coinera, při prodeji kolik prodáte bez poplatku, který je uvedený zvlášť. Pole je v odpovědi vždy. |
| estimate.quoteQuantitystring nebo null | Částka v kotovací měně jako desetinný řetězec. Když jste zadali quoteQuantity, je to tato částka. Když jste zadali quantity, je to odhad z obchodního formuláře: při nákupu celková cena včetně poplatku Coinera, při prodeji částka po poplatku; u trhů v CZK formulář ukazuje částku v CZK po převodu, která u nákupu zahrnuje rezervu na pohyb ceny. Pole je v odpovědi vždy. |
| estimate.pricestring nebo null | Odhadovaná cena za jednotku základní měny včetně poplatku Coinera a u trhů v CZK přepočtená klientským kurzem: odhadovaná tržní cena krát jedna plus sazba poplatku při nákupu, jedna minus sazba poplatku při prodeji. U tržního pokynu je to cena včetně poplatku, kterou formulář v aplikaci ukazuje; u limitního pokynu se vychází z vaší limitní ceny. Pole je v odpovědi vždy. |
| estimate.estimatedSpentApiMoney nebo null | Odhad částky, kterou zaplatíte, jak ji ukazuje formulář: u nákupu částka v kotovací měně, u prodeje s quantity množství v základní měně. Null u prodeje s quoteQuantity, protože formulář ukazuje jen množství k prodeji bez poplatku, a když chybí aktuální cena. Pole je v odpovědi vždy. |
| estimate.estimatedSpent.amountstring | Částka jako desetinný řetězec s tečkou a nejméně s tolika místy, kolik má její měna. Zpracujte ji jako desetinné číslo, ne jako číslo s pohyblivou řádovou čárkou. |
| estimate.estimatedSpent.currencystring | Kód měny částky, například BTC nebo CZK. |
| estimate.estimatedReceivedApiMoney nebo null | Odhad částky, kterou získáte, jak ji ukazuje formulář: u nákupu množství v základní měně, u prodeje částka v kotovací měně. Null, když chybí aktuální cena. Pole je v odpovědi vždy. |
| estimate.estimatedReceived.amountstring | Částka jako desetinný řetězec s tečkou a nejméně s tolika místy, kolik má její měna. Zpracujte ji jako desetinné číslo, ne jako číslo s pohyblivou řádovou čárkou. |
| estimate.estimatedReceived.currencystring | Kód měny částky, například BTC nebo CZK. |
| estimate.feeApiMoney nebo null | Odhad poplatku Coinera. U limitního pokynu je to údaj, který formulář ukazuje jako odhadovaný poplatek; u tržního pokynu formulář poplatek neuvádí a toto je poplatek obsažený v částkách výše, spočtený stejně. Účtuje se v měně, kterou získáte, když je částka zadaná v měně, kterou platíte, jinak v měně, kterou platíte. Pole je v odpovědi vždy. |
| estimate.fee.amountstring | Částka jako desetinný řetězec s tečkou a nejméně s tolika místy, kolik má její měna. Zpracujte ji jako desetinné číslo, ne jako číslo s pohyblivou řádovou čárkou. |
| estimate.fee.currencystring | Kód měny částky, například BTC nebo CZK. |
| estimate.conversionOrderEstimateConversionResponse nebo null | Převod přes můstkovou měnu u trhů, které Coinero kotuje v měně, již burza neobchoduje (například CZK přes EUR). U přímo obchodovaných trhů a když chybí aktuální cena null. Pole je v odpovědi vždy. |
| estimate.conversion.ratestring | Klientský kurz včetně měnové přirážky jako desetinný řetězec: počet jednotek kotovací měny trhu na jednu jednotku můstkové měny, například 25.2525 CZK za 1 EUR, pro nákup i prodej stejně. Tímto kurzem se přepočítávají ceny a částky v CZK v odhadu pokynu. |
| estimate.conversion.currencystring | Kód můstkové měny, přes kterou se pokyn provádí, například EUR. |
| estimate.minimumApiMoney nebo null | Minimální částka pokynu v měně zadané částky (kotovací měna u quoteQuantity, základní měna u quantity). Uvádí se jen tehdy, když je zadaná částka pod minimem a minimum lze určit, jinak null. Je mírně zaokrouhlené nahoru, aby pokyn zadaný přesně na této částce přežil drobné pohyby ceny. Pole je v odpovědi vždy. |
| estimate.minimum.amountstring | Částka jako desetinný řetězec s tečkou a nejméně s tolika místy, kolik má její měna. Zpracujte ji jako desetinné číslo, ne jako číslo s pohyblivou řádovou čárkou. |
| estimate.minimum.currencystring | Kód měny částky, například BTC nebo CZK. |
| estimate.availableboolean | True, když lze pokyn s těmito parametry zadat hned, pokud jde o trh: Coinero pár obchoduje a částka není pod minimem. Odhad vrací jen platná odpověď POST /v1/orders/validate, která už ověřila zůstatek a kontroly účtu, takže tam je available vždy true a unavailableReason vždy null. Nezaměňujte s polem available na nejvyšší úrovni odpovědi validace, které nese dostupný zůstatek měny, kterou pokyn utrácí. |
| estimate.unavailableReasonstring nebo null | Proč nelze pokyn zadat, když je available false, jinak null. Pole je v odpovědi vždy. |
| codestring nebo null | Kód chyby, který by vrátilo zadání pokynu, z katalogu chyb, nebo null, když je valid true. Pole je v odpovědi vždy. |
| detailstring nebo null | Popis chyby pro člověka, nebo null, když je valid true. Pole je v odpovědi vždy. |
| minimumPublicApiProblemAmount nebo null | Minimum trhu jako v těle chyby; vyplněné jen u kódu BELOW_MINIMUM, jinak null. Pole je v odpovědi vždy. |
| minimum.amountstring | Částka jako desetinný řetězec s tečkou a bez exponentu. |
| minimum.currencystring | Kód měny. |
| availablePublicApiProblemAmount nebo null | Dostupný zůstatek měny, kterou pokyn utrácí; vyplněný jen u kódu INSUFFICIENT_BALANCE, jinak null. Pole je v odpovědi vždy. |
| available.amountstring | Částka jako desetinný řetězec s tečkou a bez exponentu. |
| available.currencystring | Kód měny. |
| limitPublicApiProblemAmount nebo null | Obchodní limit účtu; vyplněný jen u kódu TRADING_LIMIT_EXCEEDED, jinak null. Pole je v odpovědi vždy. |
| limit.amountstring | Částka jako desetinný řetězec s tečkou a bez exponentu. |
| limit.currencystring | Kód měny. |
| remainingPublicApiProblemAmount nebo null | Část obchodního limitu, kterou lze ještě využít; vyplněná jen u kódu TRADING_LIMIT_EXCEEDED při nenulovém limitu, jinak null. Pole je v odpovědi vždy. |
| remaining.amountstring | Částka jako desetinný řetězec s tečkou a bez exponentu. |
| remaining.currencystring | Kód měny. |
| reasonstring nebo null | Proč účet nesmí obchodovat; vyplněný jen u kódu TRADING_NOT_ALLOWED, jinak null. Pole je v odpovědi vždy. |
| errorspole PublicApiOrderFieldIssue nebo null | Problémy nalezené v pokynu; vyplněné jen u kódu INVALID_ORDER, jinak null. Pole je v odpovědi vždy. |
| errors[].fieldstring nebo null | Název pole požadavku, které je chybné, nebo null, když se problém týká pokynu jako celku. Pole je v odpovědi vždy. |
| errors[].codestring | Strojově čitelný důvod, proč pole není platné, například REQUIRED nebo INVALID_VALUE. |
Hodnoty stavů
Nové hodnoty mohou přibýt i v rámci v1; neznámou hodnotu zpracujte bez selhání.
| PublicOrderSide | Význam |
|---|---|
buy | nákup: platíte kotovací měnou a získáváte základní měnu |
sell | prodej: platíte základní měnou a získáváte kotovací měnu |
| PublicOrderType | Význam |
|---|---|
market | tržní pokyn se provede za aktuální tržní cenu |
limit | limitní pokyn se provede za zadanou limitní cenu nebo lepší |
Chyby
Chyby mají formát application/problem+json; zpracovávejte je podle pole code. Podrobnosti najdete v přehledu chyb.
| Stav | Kódy | Řešení |
|---|---|---|
| 401 | MISSING_API_KEY, INVALID_API_KEY, SIGNATURE_REQUIRED, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_WINDOW | Doplňte hlavičku X-COINERO-APIKEY. Ověřte hodnotu a stav klíče i aktivitu účtu. Doplňte hlavičky X-COINERO-TIMESTAMP a X-COINERO-SIGNATURE podle stránky Podpis požadavků. Zkontrolujte kanonický řetězec (časová značka, metoda velkými písmeny, cesta s dotazem, tělo bajt po bajtu) a že secret před HMAC dekódujete z Base64; stránka Podpis požadavků má referenční vektor. Použijte aktuální čas v milisekundách; pole serverTime a serverTimeMs v odpovědi nesou čas serveru, podle kterého opravte hodiny klienta. |
| 403 | INSUFFICIENT_PERMISSION, IP_NOT_ALLOWED, TRADING_NOT_ALLOWED | Pole requiredPermission uvádí, které oprávnění chybí. Oprávnění klíče nelze změnit; vytvořte nový klíč s potřebným oprávněním. Odešlete požadavek z adresy povolené u klíče, nebo vytvořte nový klíč, jehož seznam adresu obsahuje; seznam nelze dodatečně změnit. Pole reason uvádí důvod; stejný důvod a postup řešení ukazuje aplikace Coinero. Opakování se stejným klíčem nepomůže, dokud důvod trvá. |
| 405 | METHOD_NOT_ALLOWED | Použijte metodu z hlavičky Allow: GET a HEAD ke čtení, POST a DELETE jen u operací, které je mají v dokumentaci. |
| 429 | RATE_LIMIT_EXCEEDED | Před dalším pokusem vyčkejte počet sekund z Retry-After. |
| 503 | SERVICE_MAINTENANCE, MARKET_DATA_UNAVAILABLE, PRICE_UNAVAILABLE | Probíhá údržba nebo je dočasně vypnuté obchodování či WebSocket; ověřte GET /v1/status a vyčkejte podle Retry-After. Data dočasně chybí; vyčkejte počet sekund z Retry-After a požadavek zopakujte. Chybí aktuální cena nebo převodní kurz a pokyn nevznikl; zopakujte požadavek za chvíli. |