Získat API klíč
Přehled API · Subúčty

GET /v1/subaccounts/orders

Vrací pokyny všech subúčtů vašeho partnerského účtu podle času poslední změny od nejstarší, kurzorově.

Partnerský klíč s oprávněním subaccounts

Endpoint patří do sekce Subúčty. Vyžaduje partnerský API klíč (prefix pk_) s oprávněním subaccounts a podpis požadavku; klientský klíč dostane 403 INSUFFICIENT_PERMISSION. Postup je na stránkách Podpis požadavků a Klíč partnera.

Parametry dotazu

ParametrPopis
updatedAftervolitelnéstringJen pokyny změněné po tomto okamžiku (bez něj). ISO 8601 (chybějící posun znamená UTC) nebo milisekundy od počátku Unixové epochy.
statusvolitelnéstringJen pokyny v tomto stavu, jedna hodnota stavu pokynu, nebo open pro všechny neukončené (pendingConfirmation, new, placing, open, partiallyFilled).
cursorvolitelnéstringnextCursor předchozí stránky. Neprůhledná hodnota, pošlete ji beze změny.
limitvolitelnéstringPočet pokynů na stránce, od 1 do 500. Výchozí 50.

Odpověď

200 · application/json · PartnerOrderListResponse

Je to plnohodnotná cesta ke sledování stavů pokynů; webhooky jsou doporučené doplnění. Po výpadku dočtěte změny s updatedAfter nastaveným na poslední zpracovanou změnu.

Další stránku načtete s nextCursor předchozí stránky v parametru cursor, a to i po poslední stránce, když chcete později dočíst novější změny.

Vyžaduje partnerský API klíč s oprávněním subaccounts a podepsaný požadavek. Odpověď se neukládá do cache.

Částky a ceny jsou desetinné řetězce, aby nedocházelo ke ztrátě přesnosti. Volitelná pole mohou v odpovědi zcela chybět; nenahrazují se hodnotou null.

PolePopis
itemspole OrderResponsePokyny na této stránce od nejstarší změny. Každá položka je objekt pokynu s blokem partner.
items[].orderIdstringIdentifikátor pokynu.
items[].clientOrderIdstring nebo nullVáš vlastní identifikátor pokynu tak, jak jste ho poslali, nebo null, když jste pokyn zadali bez něj. Pole je v odpovědi vždy.
items[].symbolstringSymbol trhu tak, jak byl zadán při zadání pokynu, například BTCCZK.
items[].basestringKód základní měny trhu.
items[].quotestringKód kotovací měny trhu.
items[].sidestringStrana pokynu z pohledu základní měny. Hodnoty: buy, sell.
items[].typestringTyp pokynu. Hodnoty: market, limit.
items[].statusstringStav pokynu. Hodnoty: new, placing, open, partiallyFilled, filled, cancelled, expired, rejected, pendingConfirmation.
items[].settledbooleanTrue, jakmile je pokyn vypořádaný na účtu. Naplněný pokyn se vypořádá krátce po naplnění; do té doby se získaná částka ještě může změnit.
items[].cancellablebooleanTrue, když lze pokyn v jeho stavu zrušit.
items[].requestedQuantitystring nebo nullMnožství v základní měně, které jste zadali, nebo null, když jste zadali quoteQuantity. Právě jedno z requestedQuantity a requestedQuoteQuantity je vyplněné. Pole je v odpovědi vždy.
items[].requestedQuoteQuantitystring nebo nullČástka v kotovací měně, kterou jste zadali, nebo null, když jste zadali quantity. Pole je v odpovědi vždy.
items[].pricestring nebo nullLimitní cena v kotovací měně za jednotku základní měny tak, jak jste ji zadali (u trhů v CZK v CZK), nebo null u tržního pokynu. Pole je v odpovědi vždy.
items[].filledQuantitystring nebo nullNaplněné množství v základní měně jako desetinný řetězec. Null na trhu, který Coinero kotuje opačně než burza (například USDCBTC), kde pokyn drží naplněné množství v kotovací měně. Pole je v odpovědi vždy.
items[].averagePricestring nebo nullPrůměrná cena naplnění v kotovací měně za jednotku základní měny, u trhů v CZK přepočtená kurzem pokynu, s nejméně šesti platnými číslicemi. Do prvního naplnění null. Pole je v odpovědi vždy.
items[].feeApiMoney nebo nullPoplatek Coinera za pokyn, tedy údaj, který aplikace ukazuje jako poplatek. Do naplnění nula. Null jen tehdy, když není známa měna poplatku. Pole je v odpovědi vždy.
items[].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.
items[].fee.currencystringKód měny částky, například BTC nebo CZK.
items[].spentApiMoneyČástka, kterou jste skutečně zaplatili, v měně, kterou pokyn utrácí. Do naplnění nula.
items[].spent.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.
items[].spent.currencystringKód měny částky, například BTC nebo CZK.
items[].receivedApiMoneyČástka, kterou jste skutečně získali, v měně, do které pokyn nakupuje nebo prodává, po odečtení poplatku Coinera. Do naplnění nula.
items[].received.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.
items[].received.currencystringKód měny částky, například BTC nebo CZK.
items[].conversionOrderConversionResponse 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), kurzem stanoveným pro tento pokyn; u přímo obchodovaných trhů null. Pole je v odpovědi vždy.
items[].conversion.ratestringKlientský kurz stanovený pro pokyn 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. Aplikace ho ukazuje jako použitý kurz.
items[].conversion.currencystringKód můstkové měny, přes kterou se pokyn provádí, například EUR.
items[].rejectionReasonstring nebo nullProč byl pokyn odmítnut, nebo null, když odmítnut nebyl. Pole je v odpovědi vždy.
items[].createdAtstringKdy byl pokyn vytvořen, ISO 8601, UTC, s milisekundami.
items[].createdAtMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
items[].filledAtstring nebo nullKdy byl pokyn naplněn celý, ISO 8601, UTC, jinak null. Pole je v odpovědi vždy.
items[].filledAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null. Pole je v odpovědi vždy.
items[].settledAtstring nebo nullKdy byl pokyn vypořádán, ISO 8601, UTC, jinak null. Pole je v odpovědi vždy.
items[].settledAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null. Pole je v odpovědi vždy.
items[].partnervolitelnéPartnerOrderBlockResponseÚdaje pokynu za subúčet vašeho partnerského účtu: číslo pokynu, poplatek partnera, částka k blokaci, potvrzení a vypořádání s partnerem. Jen u pokynů subúčtů; pokyny klientského účtu pole nemají.
items[].partner.orderNumberstringČíslo pokynu vašeho partnerského účtu, například ABCD-0000001234; jeho číslice jsou variabilním symbolem platby za pokyn.
items[].partner.externalClientRefstringIdentifikátor klienta ve vašem systému, za kterého pokyn je.
items[].partner.feeAmountApiMoneyPoplatek partnera: u nákupu navíc k investici (po vypořádání obchodu skutečně zaúčtovaný), u prodeje z hrubého výtěžku (do vypořádání obchodu nula).
items[].partner.feeAmount.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.
items[].partner.feeAmount.currencystringKód měny částky, například BTC nebo CZK.
items[].partner.totalAmountApiMoney nebo nullNákup: investice plus poplatek partnera, tedy částka, kterou klientovi zablokujete a Coineru zaplatíte. U prodeje null. Pole je v odpovědi vždy.
items[].partner.totalAmount.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.
items[].partner.totalAmount.currencystringKód měny částky, například BTC nebo CZK.
items[].partner.netProceedsApiMoney nebo nullProdej: výtěžek po poplatku partnera, který vám Coinero vyplatí; do vypořádání obchodu null. U nákupu null. Pole je v odpovědi vždy.
items[].partner.netProceeds.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.
items[].partner.netProceeds.currencystringKód měny částky, například BTC nebo CZK.
items[].partner.blockDeadlinestring nebo nullDo kdy musíte blokaci potvrdit, ISO 8601, UTC; jen ve stavu pendingConfirmation, jinak null. Pole je v odpovědi vždy.
items[].partner.blockDeadlineMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null. Pole je v odpovědi vždy.
items[].partner.confirmationRequiredbooleanTrue, když pokyn čekal na vaše potvrzení blokace; u prodeje a u partnera bez potvrzování false.
items[].partner.confirmedAtstring nebo nullKdy jste blokaci potvrdili, ISO 8601, UTC, jinak null. Pole je v odpovědi vždy.
items[].partner.confirmedAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null. Pole je v odpovědi vždy.
items[].partner.settledAtstring nebo nullKdy byl pokyn vypořádán s vaším partnerským účtem (spárovaná platba nebo odeslaná výplata), ISO 8601, UTC, jinak null. Pole settled pokynu je vypořádání obchodu na účtu, ne tohle. Pole je v odpovědi vždy.
items[].partner.settledAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null. Pole je v odpovědi vždy.
nextCursorstring nebo nullNeprůhledný kurzor další stránky, pošlete ho v parametru cursor. Je i na poslední stránce s položkami, aby šly později dočíst novější změny; u prázdné stránky null. Pole je v odpovědi vždy.
hasMorebooleanTrue, když za touto stránkou teď následují další pokyny.
limitinteger (int32)Nejvyšší počet pokynů na stránce, jak byl požadován.

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ší
PublicOrderStatusVýznam
newpokyn byl přijat a čeká na odeslání na burzu
placingpokyn se odesílá na burzu
openpokyn čeká na burze na naplnění
partiallyFilledpokyn je zčásti naplněný
filledpokyn je naplněný celý; vypořádání může následovat později (viz settled)
cancelledpokyn byl zrušen
expiredplatnost pokynu vypršela
rejectedpokyn byl odmítnut (viz rejectionReason)
pendingConfirmationjen pokyn za subúčet: pokyn je přijatý a čeká, až partner potvrdí blokaci prostředků; nic se zatím nezaúčtovalo

Chyby

Chyby mají formát application/problem+json; zpracovávejte je podle pole code. Podrobnosti najdete v přehledu chyb.

StavKódyŘešení
400INVALID_PARAMETEROpravte parametry uvedené v poli detail podle dokumentace. Opakovaný parametr se bere jako chybný.
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_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.
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.