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

GET /v1/reports/daily

Vrací pokyny a platby vašeho partnerského účtu za jeden pražský obchodní den, abyste je mohli porovnat se svou evidencí.

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
datevolitelnéstringPražský obchodní den ve tvaru YYYY-MM-DD, nejdříve 2020-01-01. Výchozí: předchozí pražský den. Nesmí být v budoucnu.

Odpověď

200 · application/json · DailyReportResponse

orders jsou pokyny, jejichž obchod se v ten den dokončil nebo které se s vámi v ten den vypořádaly (pokyn dokončený a vypořádaný v různé dny je v obou reportech). Každý nese trh, provedené množství, průměrnou cenu, váš poplatek, částku k vypořádání a platbu nebo výpis, kterým se vypořádal.

payments jsou vaše příchozí platby a výplaty vám připsané bankou v ten den (bookingDate), každá s pokynem nebo výpisem, ke kterému patří. statement je denní výpis, když váš účet vypořádává denním netto, jinak null.

Report dne je konečný od uzávěrky dne, ve výchozím nastavení ve 3:00 pražského času následujícího dne (final, closesAt), a potom se nemění: platba, kterou Coinero zaeviduje až po tomto okamžiku, patří do dne, kdy ji zaevidovalo, a odkazuje na původní pokyn. Vypořádání a přiřazení plateb jsou ve stavu k closesAt.

Hned po uzávěrce Coinero pošle událost webhooku report.daily.ready. Report pak stáhněte a výsledek kontroly pošlete do 8:00.

Bez date vrací report předchozího pražského dne. Budoucí den nebo den před 1. 1. 2020 vrací 400 INVALID_PARAMETER, den před vznikem vašeho účtu prázdné seznamy.

S hlavičkou Accept: text/csv dostanete táž data jako CSV (UTF-8 s BOM, oddělovač středník, oddíly report, orders, payments a statement, každý začíná řádkem section a hlavičkou; částky s desetinnou tečkou, časy ISO 8601 v UTC) s názvem souboru coinero-report-{partnerCode}-{date}.csv v Content-Disposition.

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.

PolePopis
datestringPražský obchodní den reportu, YYYY-MM-DD.
partnerDailyReportPartnerResponseVáš partnerský účet.
partner.codestringKód vašeho partnerského účtu.
finalbooleanTrue po uzávěrce dne (closesAt, ve výchozím nastavení 3:00 pražského času následujícího dne); od té chvíle se report nemění.
closesAtstringUzávěrka dne, ISO 8601 v UTC.
closesAtMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
orderspole DailyReportOrderResponsePokyny, jejichž obchod se v ten den dokončil nebo které se s vámi v ten den vypořádaly, v pořadí toho okamžiku a čísla pokynu.
orders[].orderIdstringIdentifikátor pokynu, stejný jako orderId objektu pokynu.
orders[].orderNumberstringČíslo pokynu, například ABCD-0000001234; jeho číselná část je variabilní symbol platby.
orders[].externalClientRefstringVáš identifikátor klienta subúčtu.
orders[].symbolstringSymbol trhu, například BTCCZK.
orders[].sidestringStrana pokynu. Hodnoty: buy, sell.
orders[].statusstringStav pokynu, stejný jako v objektu pokynu. Obchod pokynu v reportu je dokončený. Hodnoty: new, placing, open, partiallyFilled, filled, cancelled, expired, rejected, pendingConfirmation.
orders[].filledQuantitystring nebo nullProvedené množství v základní měně, nebo null. Pole je v odpovědi vždy.
orders[].averagePricestring nebo nullPrůměrná cena plnění v kotovací měně, nebo null. Pole je v odpovědi vždy.
orders[].feeApiMoneyVáš partnerský poplatek za pokyn.
orders[].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.
orders[].fee.currencystringKód měny částky, například BTC nebo CZK.
orders[].spentApiMoneyCo subúčet utratil.
orders[].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.
orders[].spent.currencystringKód měny částky, například BTC nebo CZK.
orders[].receivedApiMoneyCo subúčet dostal.
orders[].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.
orders[].received.currencystringKód měny částky, například BTC nebo CZK.
orders[].settlementAmountApiMoney nebo nullČástka vypořádání mezi vámi a Coinerem: u nákupu kolik platíte, u prodeje čistý výtěžek, který Coinero vyplácí. U pokynu bez plnění null. Pole je v odpovědi vždy.
orders[].settlementAmount.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.
orders[].settlementAmount.currencystringKód měny částky, například BTC nebo CZK.
orders[].settlementDirectionstring nebo nullSměr settlementAmount, nebo null. Pole je v odpovědi vždy.
orders[].completedAtstring nebo nullKdy se obchod pokynu dokončil, ISO 8601 v UTC, nebo null. Pole je v odpovědi vždy.
orders[].completedAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Nebo null. Pole je v odpovědi vždy.
orders[].filledAtstring nebo nullKdy se pokyn provedl celý, ISO 8601 v UTC, nebo null. Pole je v odpovědi vždy.
orders[].filledAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Nebo null. Pole je v odpovědi vždy.
orders[].settledAtstring nebo nullKdy se pokyn s vámi vypořádal, pokud do uzávěrky dne; jinak null. Pole je v odpovědi vždy.
orders[].settledAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Nebo null. Pole je v odpovědi vždy.
orders[].settlementSourcestring nebo nullČím se pokyn vypořádal, nebo null, když se do uzávěrky dne nevypořádal. Pole je v odpovědi vždy.
orders[].paymentIdstring nebo nullPlatba nebo výplata, která pokyn vypořádala (paymentId v payments), nebo null. Pole je v odpovědi vždy.
orders[].variableSymbolstring nebo nullVariabilní symbol té platby, nebo null. Pole je v odpovědi vždy.
orders[].statementNumberstring nebo nullČíslo denního výpisu, který pokyn vypořádal, nebo null. Pole je v odpovědi vždy.
paymentspole DailyReportPaymentResponseVaše příchozí platby a výplaty vám připsané v ten den, v pořadí jejich zaevidování.
payments[].paymentIdstringIdentifikátor platby nebo výplaty.
payments[].directionstringSměr platby. Hodnoty: incoming, outgoing.
payments[].allocationstringK čemu platba k uzávěrce dne patří. Hodnoty: order, statement, credit, creditRefund, unassigned.
payments[].amountApiMoneyČástka platby.
payments[].amount.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.
payments[].amount.currencystringKód měny částky, například BTC nebo CZK.
payments[].variableSymbolstring nebo nullVariabilní symbol platby, nebo null. Pole je v odpovědi vždy.
payments[].bookingDatestringDatum připsání podle banky, YYYY-MM-DD.
payments[].bookedAtstringKdy Coinero platbu zaevidovalo, ISO 8601 v UTC. Platba zaevidovaná po uzávěrce dne připsání patří do reportu dne zaevidování.
payments[].bookedAtMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
payments[].orderNumberstring nebo nullPokyn, ke kterému platba patří, i pokyn dřívějšího dne, nebo null. Pole je v odpovědi vždy.
payments[].statementNumberstring nebo nullDenní výpis, ke kterému platba patří, nebo null. Pole je v odpovědi vždy.
statementDailyReportStatementResponse nebo nullDenní výpis dne, když váš účet vypořádává denním netto, jinak null. Pole je v odpovědi vždy.
statement.statementNumberstringČíslo denního výpisu.
statement.variableSymbolstringVariabilní symbol platby výpisu.
statement.periodFromstringZačátek období výpisu (včetně), ISO 8601 v UTC.
statement.periodFromMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
statement.periodTostringKonec období výpisu (bez), ISO 8601 v UTC.
statement.periodToMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
statement.openingBalanceApiMoneyZůstatek na začátku období; kladný znamená, že dlužíte Coineru.
statement.openingBalance.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.
statement.openingBalance.currencystringKód měny částky, například BTC nebo CZK.
statement.closingBalanceApiMoneyZůstatek na konci období; kladný znamená, že dlužíte Coineru.
statement.closingBalance.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.
statement.closingBalance.currencystringKód měny částky, například BTC nebo CZK.
statement.fundedTotalApiMoneySoučet financování subúčtů v období.
statement.fundedTotal.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.
statement.fundedTotal.currencystringKód měny částky, například BTC nebo CZK.
statement.sweptTotalApiMoneySoučet částek vrácených ze subúčtů v období.
statement.sweptTotal.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.
statement.sweptTotal.currencystringKód měny částky, například BTC nebo CZK.
statement.receivedTotalApiMoneySoučet vašich přijatých plateb v období.
statement.receivedTotal.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.
statement.receivedTotal.currencystringKód měny částky, například BTC nebo CZK.
statement.sentTotalApiMoneySoučet výplat vám odeslaných v období.
statement.sentTotal.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.
statement.sentTotal.currencystringKód měny částky, například BTC nebo CZK.
statement.directionstringKdo komu dluží podle salda obchodů období. Hodnoty: none, partnerOwes, coineroOwes.
statement.amountApiMoneyČástka k vypořádání.
statement.amount.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.
statement.amount.currencystringKód měny částky, například BTC nebo CZK.
statement.statusstringStav výpisu k uzávěrce dne. Hodnoty: awaitingPartnerPayment, payoutPending, settled.
statement.settledAtstring nebo nullKdy se výpis vypořádal, pokud do uzávěrky dne; jinak null. Pole je v odpovědi vždy.
statement.settledAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Nebo null. Pole je v odpovědi vždy.

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
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
PublicReportPaymentDirectionVýznam
incomingvaše platba Coineru
outgoingvýplata Coinera vám
PublicReportPaymentAllocationVýznam
orderplatba vypořádala pokyn (nebo je výtěžkem pokynu)
statementplatba vypořádala denní výpis (nebo je jeho saldem)
creditplatba zůstala kreditem vašeho účtu (záloha, přeplatek)
creditRefundvratka kreditu
unassignedplatba čeká na rozhodnutí Coinera
PublicStatementDirectionVýznam
nonesaldo je nulové
partnerOwesdlužíte Coineru
coineroOwesCoinero dluží vám
PublicStatementStatusVýznam
awaitingPartnerPaymentčeká se na vaši platbu
payoutPendingvýplata vám čeká na odeslání nebo potvrzení
settledvypořádaný

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.