Listi yfir úttektir · Myntkaup API

Banka- og rafmyntaúttektir úr öllum leiðum, nýjustu fyrst. Mest mega vera 366 dagar á milli from og to.

Heimild: transactions:read eða withdrawals:create
Takmarkaflokkur: read
Auðkenning: Undirrituð

Færibreytur

typestring (enum)fyrirspurnvalfrjálst
Eitt af bank, crypto.
statusstring (enum)fyrirspurnvalfrjálst
awaiting_confirmation: rafmyntaúttekt sem bíður eftir að hlekkurinn í staðfestingarpóstinum sé opnaður; expired: hlekkurinn var ekki notaður í tæka tíð; pending: í vinnslu; completed: send; canceled: hætt við; failed: mistókst.
Eitt af awaiting_confirmation, expired, pending, completed, canceled, failed.
assetstringfyrirspurnvalfrjálst
Tákn rafmyntar, í hástöfum.
Passar við ^[A-Z0-9]{1,15}$. Dæmi: BTC.
fromstring (date-time)fyrirspurnvalfrjálst
tostring (date-time)fyrirspurnvalfrjálst
limitintegerfyrirspurnvalfrjálst
Stærð síðu, 1 til 100. Sjálfgefið 50.
1 til 100.
cursorstringfyrirspurnvalfrjálst
next_cursor af fyrri síðu.
Passar við ^[A-Za-z0-9._~=+/-]{1,512}$.

Svör

200 OK

Síða af úttektum. application/json · WithdrawalList

datafylki af Withdrawal
15 reitir í hverju staki
- idstring
  Byrjar á wd_.
- typestring (enum)
  Eitt af bank, crypto.
- statusstring (enum)
  awaiting_confirmation: rafmyntaúttekt sem bíður eftir að hlekkurinn í staðfestingarpóstinum sé opnaður; expired: hlekkurinn var ekki notaður í tæka tíð; pending: í vinnslu; completed: send; canceled: hætt við; failed: mistókst.
  Eitt af awaiting_confirmation, expired, pending, completed, canceled, failed.
- assetstring
  Tákn rafmyntar, í hástöfum.
  Passar við ^[A-Z0-9]{1,15}$.
- networkstring | null
  Aðeins rafmyntaúttektir.
- amountstring (tugatala)
  Dregið af innistæðunni, umsýslugjald meðtalið.
- feestring (tugatala)getur verið null
  Umsýslugjald úttektarinnar í rafmyntinni; null meðan það er ekki vitað.
- addressstring | null
  Aðeins rafmyntaúttektir.
- memostring | null
- bank_accountstring | null
  Aðeins bankaúttektir.
- tx_idstring | null
  Auðkenni færslunnar á bálkakeðjunni, þegar hún hefur verið send.
- sourcestring (enum)
  Hvar færslan varð til: í þessu API, í appinu eða í vefappinu.
  Eitt af public_api, app, web.
- created_atstring (date-time)
- confirm_bystring (date-time)getur verið null
  Fyrir awaiting_confirmation: hlekkurinn í staðfestingarpóstinum virkar til þessa tíma.
- completed_atstring (date-time)getur verið null
next_cursorstringgetur verið null
Sendu sem cursor fyrir næstu síðu; null á síðustu síðunni.
0 til 1024 stafir.

Öll svör bera MK-Request-Id, auk RateLimit-Policy og RateLimit.

Villur

Villur nota villuumslagið. Greindu þær eftir code.

Staða	Kóði	Merking
400	`invalid_request`	Beiðnin er gölluð: ógilt JSON, óþekktur eða ógildur reitur, eða haus vantar.
401	`invalid_signature`	`MK-*` hausana vantar eða þeir eru gallaðir, auðkenni lykilsins er óþekkt eða undirskriftin passar ekki.
401	`key_expired`	Gildistími lykilsins er liðinn.
401	`key_revoked`	Lykillinn var afturkallaður.
401	`timestamp_out_of_range`	`MK-Timestamp` munar meira en 30 sekúndum frá klukku netþjónsins.
401	`nonce_reused`	Þessi lykill hefur þegar notað þetta `MK-Nonce`.
403	`ip_not_allowed`	Beiðnin kom frá IP tölu sem er ekki meðal leyfðra IP talna lykilsins.
403	`insufficient_scope`	Lykilinn vantar heimildina sem þessi endapunktur þarf.
403	`account_restricted`	Aðgangurinn getur ekki notað API-ið eins og er (til dæmis læstur, óvirkur eða nýskráningu ólokið).
403	`api_access_disabled`	Slökkt er á aðgangi að API-inu.
429	`rate_limited`	Of margar beiðnir. Bíddu í `Retry-After` sekúndur.
429	`too_many_concurrent_requests`	Of margar beiðnir í vinnslu í einu fyrir þennan lykil eða aðgang.
429	`key_suspended`	Lykillinn er stöðvaður, til dæmis eftir að hafa farið ítrekað yfir beiðnatakmörk.
500	`internal_error`	Eitthvað fór úrskeiðis hjá okkur.
502	`bad_gateway`	Undirliggjandi þjónusta svaraði á óvæntan hátt.
503	`overloaded`	Þjónustan er undir of miklu álagi. Reyndu aftur eftir `Retry-After` sekúndur.
503	`service_unavailable`	Þjónustan er tímabundið ekki tiltæk.
504	`gateway_timeout`	Undirliggjandi þjónusta svaraði ekki í tæka tíð. `POST` beiðni gæti samt klárast; reyndu aftur með sama `Idempotency-Key`.

# Signed by sign-headers.sh: see Authentication
curl "https://public-api.myntkaup.is/v1/withdrawals?type=bank&limit=10" \
  $(./sign-headers.sh GET "/v1/withdrawals?type=bank&limit=10" | sed 's/^/-H /')

import { Myntkaup } from "@myntkaup/api";

const client = new Myntkaup(); // reads the key from the environment
const page = await client.withdrawals.list({ type: "bank", limit: 10 });
console.log(page.data.map((withdrawal) => [withdrawal.id, withdrawal.status]));

from myntkaup import Myntkaup

client = Myntkaup()  # reads the key from the environment
page = client.withdrawals.list(type="bank", limit=10)
print([(withdrawal["id"], withdrawal["status"]) for withdrawal in page["data"]])

200 OK

{
  "data": [
    {
      "id": "wd_01JB8X2Q4M7Z3V9K5T1N6R0P2W",
      "type": "crypto",
      "status": "completed",
      "asset": "BTC",
      "network": "bitcoin",
      "amount": "0.01",
      "fee": "0.0005",
      "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "memo": null,
      "bank_account": null,
      "tx_id": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
      "source": "public_api",
      "created_at": "2026-11-03T10:15:10Z",
      "confirm_by": null,
      "completed_at": "2026-11-03T10:31:44Z"
    }
  ],
  "next_cursor": "eyJpZCI6IjY3MjdhMWMzIn0"
}

Grunnslóð https://public-api.myntkaup.is