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.
Responses
200 OK
The prices. application/json · PriceList
tierstringThe account's fee tier.
as_ofstring (date-time)dataarray of Price5 properties of each item
assetstringAn upper-case asset symbol.
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.
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | The request is malformed: bad JSON, an unknown or invalid field, or a missing header. |
| 401 | invalid_signature | The MK-* headers are missing or malformed, the key id is unknown, or the signature doesn't match. |
| 401 | key_expired | The key has passed its expiry date. |
| 401 | key_revoked | The key was revoked. |
| 401 | timestamp_out_of_range | MK-Timestamp is more than 30 seconds from the server clock. |
| 401 | nonce_reused | This key already used this MK-Nonce. |
| 403 | ip_not_allowed | The request came from an address outside the key's IP allowlist. |
| 429 | rate_limited | Too many requests. Wait for Retry-After seconds. |
| 429 | too_many_concurrent_requests | Too many requests in flight for this key or account. |
| 429 | key_suspended | The key is suspended, for example after sustained rate limiting. |
| 500 | internal_error | Something went wrong on our side. |
| 502 | bad_gateway | An upstream service answered unexpectedly. |
| 503 | overloaded | The service is overloaded. Retry after Retry-After seconds. |
| 503 | service_unavailable | The service is temporarily unavailable. |
| 504 | gateway_timeout | An 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
{
"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