API lýsing · Færslusaga

Sækja færslu

GET/v1/transactions/{id}

Takmarkaflokkur
read
Auðkenning
Undirrituð

Færibreytur

  • idstringslóðskylda

    Byrjar á tx_. Dæmi: tx_01JB8X2Q4M7Z3V9K5T1N6R0P2W.

  • langstring (enum)fyrirspurnvalfrjálst

    Tungumál label. Sjálfgefið en.

    Eitt af en, is.

Svör

200 OK

Færslan. application/json · Transaction

  • idstring

    Byrjar á tx_.

  • typestring (enum)

    Eitt af trade, deposit, withdrawal, fee, gift, giftcode, referral_bonus, loan, hold, other.

  • actionstring
  • labelstring
  • changesfylki af object
    3 reitir í hverju staki
    • assetstring

      Tákn rafmyntar, í hástöfum.

      Passar við ^[A-Z0-9]{1,15}$.

    • amountstring (tugatala)
    • balance_afterstring (tugatala)
  • created_atstring (date-time)

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

Villur

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

StaðaKóðiMerking
400invalid_requestBeiðnin er gölluð: ógilt JSON, óþekktur eða ógildur reitur, eða haus vantar.
401invalid_signatureMK-* hausana vantar eða þeir eru gallaðir, auðkenni lykilsins er óþekkt eða undirskriftin passar ekki.
401key_expiredGildistími lykilsins er liðinn.
401key_revokedLykillinn var afturkallaður.
401timestamp_out_of_rangeMK-Timestamp munar meira en 30 sekúndum frá klukku netþjónsins.
401nonce_reusedÞessi lykill hefur þegar notað þetta MK-Nonce.
403ip_not_allowedBeiðnin kom frá IP tölu sem er ekki meðal leyfðra IP talna lykilsins.
403insufficient_scopeLykilinn vantar heimildina sem þessi endapunktur þarf.
403account_restrictedAðgangurinn getur ekki notað API-ið eins og er (til dæmis læstur, óvirkur eða nýskráningu ólokið).
403api_access_disabledSlökkt er á aðgangi að API-inu.
404not_foundÞetta fannst ekki.
429rate_limitedOf margar beiðnir. Bíddu í Retry-After sekúndur.
429too_many_concurrent_requestsOf margar beiðnir í vinnslu í einu fyrir þennan lykil eða aðgang.
429key_suspendedLykillinn er stöðvaður, til dæmis eftir að hafa farið ítrekað yfir beiðnatakmörk.
500internal_errorEitthvað fór úrskeiðis hjá okkur.
502bad_gatewayUndirliggjandi þjónusta svaraði á óvæntan hátt.
503overloadedÞjónustan er undir of miklu álagi. Reyndu aftur eftir Retry-After sekúndur.
503service_unavailableÞjónustan er tímabundið ekki tiltæk.
504gateway_timeoutUndirliggjandi þjónusta svaraði ekki í tæka tíð. POST beiðni gæti samt klárast; reyndu aftur með sama Idempotency-Key.

Beiðni

# Signed by sign-headers.sh: see Authentication
curl https://public-api.myntkaup.is/v1/transactions/tx_01JB8X2Q4M7Z3V9K5T1N6R0P2W \
  $(./sign-headers.sh GET /v1/transactions/tx_01JB8X2Q4M7Z3V9K5T1N6R0P2W | sed 's/^/-H /')
import { Myntkaup } from "@myntkaup/api";

const client = new Myntkaup(); // reads the key from the environment
const entry = await client.transactions.get("tx_01JB8X2Q4M7Z3V9K5T1N6R0P2W");
console.log(entry.label, entry.changes);
from myntkaup import Myntkaup

client = Myntkaup()  # reads the key from the environment
entry = client.transactions.get("tx_01JB8X2Q4M7Z3V9K5T1N6R0P2W")
print(entry["label"], entry["changes"])

Svar

200 OK
{
  "id": "tx_01JB8X2Q4M7Z3V9K5T1N6R0P2W",
  "type": "trade",
  "action": "buy-btc-usdc",
  "label": "Buy BTC",
  "changes": [
    {
      "asset": "USDC",
      "amount": "-100.00",
      "balance_after": "900.00"
    },
    {
      "asset": "BTC",
      "amount": "0.00104210",
      "balance_after": "0.00104210"
    }
  ],
  "created_at": "2026-11-03T10:15:10Z"
}

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