Authentication

curl -s https://masterid.me/api/public/v1/catalog \
  -H "X-API-Key: $MASTERID_API_KEY" \
  -H "X-API-Secret: $MASTERID_API_SECRET" \
  -H "Content-Type: application/json"

// Reusable fetch wrapper for Node.js 18+
const BASE = "https://masterid.me/api/public/v1";

async function masteridFetch(path, opts = {}) {
  const res = await fetch(`${BASE}${path}`, {
    ...opts,
    headers: {
      "X-API-Key": process.env.MASTERID_API_KEY,
      "X-API-Secret": process.env.MASTERID_API_SECRET,
      "Content-Type": "application/json",
      ...opts.headers,
    },
  });

  if (!res.ok) {
    const body = await res.json().catch(() => ({}));
    throw new Error(body.error || `HTTP ${res.status}`);
  }
  return res.json();
}

(async () => {
  const { data } = await masteridFetch("/wallet");
  console.log("Balance:", data.balance, data.currency);
})();

# Reusable client for Python (requests)
import os, requests

BASE = "https://masterid.me/api/public/v1"
AUTH_HEADERS = {
    "X-API-Key": os.environ["MASTERID_API_KEY"],
    "X-API-Secret": os.environ["MASTERID_API_SECRET"],
    "Content-Type": "application/json",
}


def masterid_request(method, path, **kwargs):
    url = f"{BASE}{path}"
    headers = {**AUTH_HEADERS, **kwargs.pop("headers", {})}
    r = requests.request(method, url, headers=headers, **kwargs)
    r.raise_for_status()
    return r.json()


data = masterid_request("GET", "/wallet")["data"]
print("Balance:", data["balance"], data["currency"])