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
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
| Parametr | Popis |
|---|---|
| externalClientRefpovinnéstring | Identifiká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 · SubaccountPositionsResponseHodnota 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.
| Pole | Popis |
|---|---|
| itemspole SubaccountPositionResponse | Pozice po jedné na kryptoměnu, seřazené podle kódu měny. Kryptoměny s nulovým zůstatkem se vynechávají. |
| items[].currencystring | Kód kryptoměny, například BTC. |
| items[].quantitystring | Celkové držené množství, dostupné i blokované, jako desetinný řetězec v přesnosti měny (total ze zůstatků). |
| items[].blockedQuantitystring | Blokovaná část množství, například otevřeným pokynem; desetinný řetězec. |
| items[].valueApiMoney nebo null | Hodnota 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.currencystring | Kód měny částky, například BTC nebo CZK. |
| items[].averagePriceApiMoney nebo null | Prů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.currencystring | Kó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.
| Stav | Kódy | Řešení |
|---|---|---|
| 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. |
| 404 | CLIENT_NOT_FOUND | Ověř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. |
| 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. |