Limits and usage · Myntkaup API

Trade limits and today's use (UTC day, public API trades only), gift card quotas (every channel), and this key's rate limits.

Scope: account:read
Rate-limit class: read
Authentication: Signed

Responses

200 OK

The limits. application/json · Limits

tradeTradeLimits
6 properties
- min_usdcstring (decimal)
- max_usdcstring (decimal)
- daily_volume_usdcstring (decimal)
- daily_volume_used_usdcstring (decimal)
- daily_tradesinteger
- daily_trades_usedinteger
giftcardsGiftcardLimits
8 properties
- enabledboolean
- max_per_card_eurstring (decimal)
- per_dayinteger
- used_todayinteger
- per_30_daysinteger
- used_30_daysinteger
- value_30_days_eurstring (decimal)
- value_used_30_days_eurstring (decimal)
rate_limitsRateLimits
2 properties
- classesobject
  6 properties
  - marketobject
    2 properties
    per_keyarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
    per_accountarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
  - readobject
    2 properties
    per_keyarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
    per_accountarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
  - quoteobject
    2 properties
    per_keyarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
    per_accountarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
  - tradeobject
    2 properties
    per_keyarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
    per_accountarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
  - giftcardobject
    2 properties
    per_keyarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
    per_accountarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
  - withdrawalobject
    2 properties
    per_keyarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
    per_accountarray of object
    3 properties of each item
    limitinteger
    Tokens added per interval.
    interval_secondsinteger
    burstinteger
    The most requests that can be made at once.
- concurrencyobject
  2 properties
  - per_keyinteger
  - per_accountinteger

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.
403	`insufficient_scope`	The key doesn't have the scope this endpoint needs.
403	`account_restricted`	The account can't use the API right now (for example locked, inactive, or onboarding not finished).
403	`api_access_disabled`	API access is switched off.
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.

# Signed by sign-headers.sh: see Authentication
curl https://public-api.myntkaup.is/v1/limits \
  $(./sign-headers.sh GET /v1/limits | sed 's/^/-H /')

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

const client = new Myntkaup(); // reads the key from the environment
const limits = await client.limits.get();
console.log(limits.trade.daily_volume_used_usdc, limits.trade.daily_volume_usdc);

from myntkaup import Myntkaup

client = Myntkaup()  # reads the key from the environment
limits = client.limits.get()
print(limits["trade"]["daily_volume_used_usdc"], limits["trade"]["daily_volume_usdc"])

200 OK

{
  "trade": {
    "min_usdc": "2",
    "max_usdc": "10000",
    "daily_volume_usdc": "50000",
    "daily_volume_used_usdc": "120.00",
    "daily_trades": 500,
    "daily_trades_used": 3
  },
  "giftcards": {
    "enabled": true,
    "max_per_card_eur": "1000",
    "per_day": 5,
    "used_today": 0,
    "per_30_days": 20,
    "used_30_days": 1,
    "value_30_days_eur": "2000",
    "value_used_30_days_eur": "25"
  },
  "rate_limits": {
    "classes": {
      "market": {
        "per_key": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ],
        "per_account": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ]
      },
      "read": {
        "per_key": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ],
        "per_account": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ]
      },
      "quote": {
        "per_key": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ],
        "per_account": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ]
      },
      "trade": {
        "per_key": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ],
        "per_account": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ]
      },
      "giftcard": {
        "per_key": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ],
        "per_account": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ]
      },
      "withdrawal": {
        "per_key": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ],
        "per_account": [
          {
            "limit": 0,
            "interval_seconds": 0,
            "burst": 0
          }
        ]
      }
    },
    "concurrency": {
      "per_key": 0,
      "per_account": 0
    }
  }
}

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