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
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
| Parametr | Popis |
|---|---|
| datevolitelnéstring | Praž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 · DailyReportResponseorders 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.
| Pole | Popis |
|---|---|
| datestring | Pražský obchodní den reportu, YYYY-MM-DD. |
| partnerDailyReportPartnerResponse | Váš partnerský účet. |
| partner.codestring | Kód vašeho partnerského účtu. |
| finalboolean | True 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í. |
| closesAtstring | Uzávěrka dne, ISO 8601 v UTC. |
| closesAtMsinteger (int64) | Stejný okamžik jako Unix timestamp v milisekundách. |
| orderspole DailyReportOrderResponse | Pokyny, 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[].orderIdstring | Identifikátor pokynu, stejný jako orderId objektu pokynu. |
| orders[].orderNumberstring | Číslo pokynu, například ABCD-0000001234; jeho číselná část je variabilní symbol platby. |
| orders[].externalClientRefstring | Váš identifikátor klienta subúčtu. |
| orders[].symbolstring | Symbol trhu, například BTCCZK. |
| orders[].sidestring | Strana pokynu. Hodnoty: buy, sell. |
| orders[].statusstring | Stav 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 null | Provedené množství v základní měně, nebo null. Pole je v odpovědi vždy. |
| orders[].averagePricestring nebo null | Průměrná cena plnění v kotovací měně, nebo null. Pole je v odpovědi vždy. |
| orders[].feeApiMoney | Váš 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.currencystring | Kód měny částky, například BTC nebo CZK. |
| orders[].spentApiMoney | Co 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.currencystring | Kód měny částky, například BTC nebo CZK. |
| orders[].receivedApiMoney | Co 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.currencystring | Kó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.currencystring | Kód měny částky, například BTC nebo CZK. |
| orders[].settlementDirectionstring nebo null | Směr settlementAmount, nebo null. Pole je v odpovědi vždy. |
| orders[].completedAtstring nebo null | Kdy se obchod pokynu dokončil, ISO 8601 v UTC, nebo null. Pole je v odpovědi vždy. |
| orders[].completedAtMsinteger nebo null | Stejný okamžik jako Unix timestamp v milisekundách. Nebo null. Pole je v odpovědi vždy. |
| orders[].filledAtstring nebo null | Kdy se pokyn provedl celý, ISO 8601 v UTC, nebo null. Pole je v odpovědi vždy. |
| orders[].filledAtMsinteger nebo null | Stejný okamžik jako Unix timestamp v milisekundách. Nebo null. Pole je v odpovědi vždy. |
| orders[].settledAtstring nebo null | Kdy 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 null | Stejný 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 null | Platba nebo výplata, která pokyn vypořádala (paymentId v payments), nebo null. Pole je v odpovědi vždy. |
| orders[].variableSymbolstring nebo null | Variabilní 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 DailyReportPaymentResponse | Vaše příchozí platby a výplaty vám připsané v ten den, v pořadí jejich zaevidování. |
| payments[].paymentIdstring | Identifikátor platby nebo výplaty. |
| payments[].directionstring | Směr platby. Hodnoty: incoming, outgoing. |
| payments[].allocationstring | K č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.currencystring | Kód měny částky, například BTC nebo CZK. |
| payments[].variableSymbolstring nebo null | Variabilní symbol platby, nebo null. Pole je v odpovědi vždy. |
| payments[].bookingDatestring | Datum připsání podle banky, YYYY-MM-DD. |
| payments[].bookedAtstring | Kdy 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 null | Pokyn, ke kterému platba patří, i pokyn dřívějšího dne, nebo null. Pole je v odpovědi vždy. |
| payments[].statementNumberstring nebo null | Denní výpis, ke kterému platba patří, nebo null. Pole je v odpovědi vždy. |
| statementDailyReportStatementResponse nebo null | Denní 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.variableSymbolstring | Variabilní symbol platby výpisu. |
| statement.periodFromstring | Začátek období výpisu (včetně), ISO 8601 v UTC. |
| statement.periodFromMsinteger (int64) | Stejný okamžik jako Unix timestamp v milisekundách. |
| statement.periodTostring | Konec období výpisu (bez), ISO 8601 v UTC. |
| statement.periodToMsinteger (int64) | Stejný okamžik jako Unix timestamp v milisekundách. |
| statement.openingBalanceApiMoney | Zů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.currencystring | Kód měny částky, například BTC nebo CZK. |
| statement.closingBalanceApiMoney | Zů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.currencystring | Kód měny částky, například BTC nebo CZK. |
| statement.fundedTotalApiMoney | Souč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.currencystring | Kód měny částky, například BTC nebo CZK. |
| statement.sweptTotalApiMoney | Souč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.currencystring | Kód měny částky, například BTC nebo CZK. |
| statement.receivedTotalApiMoney | Souč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.currencystring | Kód měny částky, například BTC nebo CZK. |
| statement.sentTotalApiMoney | Souč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.currencystring | Kód měny částky, například BTC nebo CZK. |
| statement.directionstring | Kdo 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.currencystring | Kód měny částky, například BTC nebo CZK. |
| statement.statusstring | Stav výpisu k uzávěrce dne. Hodnoty: awaitingPartnerPayment, payoutPending, settled. |
| statement.settledAtstring nebo null | Kdy se výpis vypořádal, pokud do uzávěrky dne; jinak null. Pole je v odpovědi vždy. |
| statement.settledAtMsinteger nebo null | Stejný 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í.
| 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 |
| PublicOrderStatus | Význam |
|---|---|
new | pokyn byl přijat a čeká na odeslání na burzu |
placing | pokyn se odesílá na burzu |
open | pokyn čeká na burze na naplnění |
partiallyFilled | pokyn je zčásti naplněný |
filled | pokyn je naplněný celý; vypořádání může následovat později (viz settled) |
cancelled | pokyn byl zrušen |
expired | platnost pokynu vypršela |
rejected | pokyn byl odmítnut (viz rejectionReason) |
pendingConfirmation | jen pokyn za subúčet: pokyn je přijatý a čeká, až partner potvrdí blokaci prostředků; nic se zatím nezaúčtovalo |
| PublicReportPaymentDirection | Význam |
|---|---|
incoming | vaše platba Coineru |
outgoing | výplata Coinera vám |
| PublicReportPaymentAllocation | Význam |
|---|---|
order | platba vypořádala pokyn (nebo je výtěžkem pokynu) |
statement | platba vypořádala denní výpis (nebo je jeho saldem) |
credit | platba zůstala kreditem vašeho účtu (záloha, přeplatek) |
creditRefund | vratka kreditu |
unassigned | platba čeká na rozhodnutí Coinera |
| PublicStatementDirection | Význam |
|---|---|
none | saldo je nulové |
partnerOwes | dlužíte Coineru |
coineroOwes | Coinero dluží vám |
| PublicStatementStatus | Význam |
|---|---|
awaitingPartnerPayment | čeká se na vaši platbu |
payoutPending | výplata vám čeká na odeslání nebo potvrzení |
settled | vypořádaný |
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í |
|---|---|---|
| 400 | INVALID_PARAMETER | Opravte parametry uvedené v poli detail podle dokumentace. Opakovaný parametr se bere jako chybný. |
| 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 | 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. |
| 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. |