Firms, participants and accounts

# Canonical token client from the "Authentication" section
from polymarket_auth import PolymarketClient

import requests

# From the `participantId` on the kyc.approved webhook for this user (see "Firms, participants and accounts").
# Never constructed by hand, never derived from GET /v1/whoami.
PARTICIPANT_ID = "REPLACE_WITH_PARTICIPANT_ID_FROM_WEBHOOK"

client = PolymarketClient()

resp = requests.get(
    f"{client.api_base_url}/v1/users",
    headers={
        "authorization": f"Bearer {client.access_token()}",
        "x-participant-id": PARTICIPANT_ID,  # required: /v1/users is account-scoped
    },
    timeout=10,
)
resp.raise_for_status()  # 403 here almost always means a missing or wrong header
print(resp.json())

// Canonical token client from the "Authentication" section
import { PolymarketClient } from "./polymarketAuth";

// From the `participantId` on the kyc.approved webhook for this user (see "Firms, participants and accounts").
const PARTICIPANT_ID = "REPLACE_WITH_PARTICIPANT_ID_FROM_WEBHOOK";
const API_BASE_URL = "https://api.preprod.polymarketexchange.com"; // see "Environments and endpoints"

const client = new PolymarketClient();

const res = await fetch(`${API_BASE_URL}/v1/users`, {
  headers: {
    authorization: `Bearer ${await client.accessToken()}`,
    "x-participant-id": PARTICIPANT_ID, // required: /v1/users is account-scoped
  },
});
if (!res.ok) throw new Error(`GET /v1/users ${res.status}: ${await res.text()}`);
console.log(await res.json());

#!/usr/bin/env bash
set -euo pipefail

# ACCESS_TOKEN comes from token.sh in "Authentication".
ACCESS_TOKEN="${ACCESS_TOKEN:?run token.sh from the Authentication section first}"
# From the `participantId` on the kyc.approved webhook for this user.
PARTICIPANT_ID="REPLACE_WITH_PARTICIPANT_ID_FROM_WEBHOOK"
API_BASE_URL="https://api.preprod.polymarketexchange.com"   # see "Environments and endpoints"

curl -sS --fail-with-body "${API_BASE_URL}/v1/users" \
  -H "authorization: Bearer ${ACCESS_TOKEN}" \
  -H "x-participant-id: ${PARTICIPANT_ID}"

package main

import (
	"fmt"
	"io"
	"net/http"

	// Canonical token client from the "Authentication" section
	"example.com/yourfirm/pmauth"
)

// From the `participantId` on the kyc.approved webhook for this user (see "Firms, participants and accounts").
const ParticipantID = "REPLACE_WITH_PARTICIPANT_ID_FROM_WEBHOOK"

func main() {
	client := pmauth.New()
	tok, err := client.AccessToken()
	if err != nil {
		panic(err)
	}

	req, _ := http.NewRequest(http.MethodGet, pmauth.APIBaseURL+"/v1/users", nil)
	req.Header.Set("authorization", "Bearer "+tok)
	req.Header.Set("x-participant-id", ParticipantID) // required: /v1/users is account-scoped

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	if resp.StatusCode != http.StatusOK {
		panic(fmt.Sprintf("GET /v1/users %d: %s", resp.StatusCode, body))
	}
	fmt.Println(string(body))
}