Získat API klíč
Přehled API · Pokyny

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

Endpoint vyžaduje API klíč s oprávněním 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 · PlaceOrderBody

Podepiš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é.

PolePopis
symbolpovinnéstringSymbol trhu z GET /v1/markets, například BTCEUR nebo BTCCZK; velikost písmen nerozhoduje.
sidepovinnéstringbuy nebo sell z pohledu základní měny trhu. Jen malými písmeny. Hodnoty: buy, sell.
typepovinnéstringmarket nebo limit. Jen malými písmeny. Hodnoty: market, limit.
quantityvolitelnéstringMnož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éstringLimitní 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éstringVáš 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 · ValidateOrderResponse

Nic 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.

PolePopis
validbooleanTrue, když by zadání pokynu s tímto tělem teď bylo přijato.
estimateOrderEstimateResponse nebo nullNezá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.symbolstringSymbol trhu tak, jak byl požadován, například BTCCZK.
estimate.basestringKód základní měny, například BTC.
estimate.quotestringKód kotovací měny, například CZK.
estimate.sidestringStrana odhadovaného pokynu, jak byla požadována. Hodnoty: buy, sell.
estimate.typestringTyp odhadovaného pokynu, jak byl požadován. Hodnoty: market, limit.
estimate.quantitystring nebo nullMnož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 nullOdhadovaná 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 nullOdhad čá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.currencystringKód měny částky, například BTC nebo CZK.
estimate.estimatedReceivedApiMoney nebo nullOdhad čá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.currencystringKód měny částky, například BTC nebo CZK.
estimate.feeApiMoney nebo nullOdhad 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.currencystringKód měny částky, například BTC nebo CZK.
estimate.conversionOrderEstimateConversionResponse nebo nullPř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.ratestringKlientský 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.currencystringKód můstkové měny, přes kterou se pokyn provádí, například EUR.
estimate.minimumApiMoney nebo nullMinimá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.currencystringKód měny částky, například BTC nebo CZK.
estimate.availablebooleanTrue, 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 nullProč nelze pokyn zadat, když je available false, jinak null. Pole je v odpovědi vždy.
codestring nebo nullKó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 nullPopis chyby pro člověka, nebo null, když je valid true. Pole je v odpovědi vždy.
minimumPublicApiProblemAmount nebo nullMinimum 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.currencystringKód měny.
availablePublicApiProblemAmount nebo nullDostupný 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.currencystringKód měny.
limitPublicApiProblemAmount nebo nullObchodní 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.currencystringKó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.currencystringKód měny.
reasonstring nebo nullProč účet nesmí obchodovat; vyplněný jen u kódu TRADING_NOT_ALLOWED, jinak null. Pole je v odpovědi vždy.
errorspole PublicApiOrderFieldIssue nebo nullProblémy nalezené v pokynu; vyplněné jen u kódu INVALID_ORDER, jinak null. Pole je v odpovědi vždy.
errors[].fieldstring nebo nullNá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[].codestringStrojově č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í.

PublicOrderSideVýznam
buynákup: platíte kotovací měnou a získáváte základní měnu
sellprodej: platíte základní měnou a získáváte kotovací měnu
PublicOrderTypeVýznam
markettržní pokyn se provede za aktuální tržní cenu
limitlimitní 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.

StavKódyŘešení
401MISSING_API_KEY, INVALID_API_KEY, SIGNATURE_REQUIRED, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_WINDOWDoplň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.
403INSUFFICIENT_PERMISSION, IP_NOT_ALLOWED, TRADING_NOT_ALLOWEDPole 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á.
405METHOD_NOT_ALLOWEDPoužijte metodu z hlavičky Allow: GET a HEAD ke čtení, POST a DELETE jen u operací, které je mají v dokumentaci.
429RATE_LIMIT_EXCEEDEDPřed dalším pokusem vyčkejte počet sekund z Retry-After.
503SERVICE_MAINTENANCE, MARKET_DATA_UNAVAILABLE, PRICE_UNAVAILABLEProbí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.