API reference · Market data

Prices at your tier

GET/v1/prices

Buy and sell prices of every asset at the key's account tier, in USDC. Cached for up to 1 s.

Scope
Any valid key.
Rate-limit class
market
Authentication
Signed

Responses

200 OK

The prices. application/json · PriceList

  • tierstring

    The account's fee tier.

    Matches ^tier-\d{1,3}$.

  • as_ofstring (date-time)
  • dataarray of Price
    5 properties of each item
    • assetstring

      An upper-case asset symbol.

      Matches ^[A-Z0-9]{1,15}$.

    • quote_currency"USDC"
    • buystring (decimal)
    • sellstring (decimal)
    • updated_atstring (date-time)

Every response carries MK-Request-Id, plus RateLimit-Policy and RateLimit.

Errors

Errors use the error envelope. Match on code.

StatusCodeMeaning
400invalid_requestThe request is malformed: bad JSON, an unknown or invalid field, or a missing header.
401invalid_signatureThe MK-* headers are missing or malformed, the key id is unknown, or the signature doesn't match.
401key_expiredThe key has passed its expiry date.
401key_revokedThe key was revoked.
401timestamp_out_of_rangeMK-Timestamp is more than 30 seconds from the server clock.
401nonce_reusedThis key already used this MK-Nonce.
403ip_not_allowedThe request came from an address outside the key's IP allowlist.
429rate_limitedToo many requests. Wait for Retry-After seconds.
429too_many_concurrent_requestsToo many requests in flight for this key or account.
429key_suspendedThe key is suspended, for example after sustained rate limiting.
500internal_errorSomething went wrong on our side.
502bad_gatewayAn upstream service answered unexpectedly.
503overloadedThe service is overloaded. Retry after Retry-After seconds.
503service_unavailableThe service is temporarily unavailable.
504gateway_timeoutAn upstream service didn't answer in time. A POST may still complete; retry with the same Idempotency-Key.

Request

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

const client = new Myntkaup(); // reads the key from the environment
const prices = await client.prices.list();
const btc = prices.data.find((price) => price.asset === "BTC");
console.log(prices.tier, btc?.buy, btc?.sell);
from myntkaup import Myntkaup

client = Myntkaup()  # reads the key from the environment
prices = client.prices.list()
btc = next(p for p in prices["data"] if p["asset"] == "BTC")
print(prices["tier"], btc["buy"], btc["sell"])

Response

200 OK
{
  "tier": "tier-1",
  "as_of": "2026-11-03T10:15:10Z",
  "data": [
    {
      "asset": "BTC",
      "quote_currency": "USDC",
      "buy": "96000.12",
      "sell": "94100.55",
      "updated_at": "2026-11-03T10:15:09Z"
    }
  ]
}

Base URL https://public-api.myntkaup.is