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

GET /v1/subaccounts/{externalClientRef}/positions

Vrací pozice subúčtu v kryptoměnách s hodnotou v měně vypořádání a průměrnou nákupní cenou.

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 cesty

ParametrPopis
externalClientRefpovinnéstringIdentifikátor klienta ve vašem systému přesně tak, jak jste ho poslali při založení subúčtu, včetně velikosti písmen: 1 až 64 písmen bez diakritiky, číslic, pomlček a podtržítek.

Odpověď

200 · application/json · SubaccountPositionsResponse

Hodnota je množství krát aktuální prodejní cena klienta (sellPrice z GET /v1/ticker), zaokrouhlená dolů; bez ceny je null.

Průměrná nákupní cena je vážený průměr jako v aplikaci Coinero; když ji nejde spolehlivě spočítat, je null.

Vyžaduje partnerský API klíč s oprávněním subaccounts a podepsaný požadavek. Funguje pro subúčet v každém stavu kromě zamítnutého; neexistující, cizí nebo zamítnutý subúčet vrací 404 CLIENT_NOT_FOUND.

Odpověď se neukládá do cache.

Částky a ceny jsou desetinné řetězce, aby nedocházelo ke ztrátě přesnosti.

PolePopis
itemspole SubaccountPositionResponsePozice po jedné na kryptoměnu, seřazené podle kódu měny. Kryptoměny s nulovým zůstatkem se vynechávají.
items[].currencystringKód kryptoměny, například BTC.
items[].quantitystringCelkové držené množství, dostupné i blokované, jako desetinný řetězec v přesnosti měny (total ze zůstatků).
items[].blockedQuantitystringBlokovaná část množství, například otevřeným pokynem; desetinný řetězec.
items[].valueApiMoney nebo nullHodnota množství v měně vypořádání partnera za aktuální prodejní cenu klienta, zaokrouhlená dolů; null, když cena není k dispozici. Pole je v odpovědi vždy.
items[].value.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[].value.currencystringKód měny částky, například BTC nebo CZK.
items[].averagePriceApiMoney nebo nullPrůměrná nákupní cena jedné jednotky drženého množství, vážená jako v aplikaci Coinero; null, když ji nejde spolehlivě spočítat nebo měna vypořádání není CZK. Pole je v odpovědi vždy.
items[].averagePrice.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[].averagePrice.currencystringKód měny částky, například BTC nebo CZK.

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_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.
404CLIENT_NOT_FOUNDOvěřte externalClientRef včetně velikosti písmen; neexistující, cizí i zamítnutý subúčet vracejí stejnou chybu. Subúčet založte přes POST /v1/subaccounts.
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.