Quickstart

npm install polymarket-us

pip install polymarket-us

import { PolymarketUS } from 'polymarket-us';

const client = new PolymarketUS({
  keyId: process.env.POLYMARKET_KEY_ID,
  secretKey: process.env.POLYMARKET_SECRET_KEY,
});

import os
from polymarket_us import PolymarketUS

client = PolymarketUS(
    key_id=os.environ["POLYMARKET_KEY_ID"],
    secret_key=os.environ["POLYMARKET_SECRET_KEY"],
)

const client = new PolymarketUS();

const events = await client.events.list({ limit: 10, active: true });
const market = await client.markets.retrieveBySlug('chiefs-super-bowl');
const book = await client.markets.book('chiefs-super-bowl');

client = PolymarketUS()

events = client.events.list({"limit": 10, "active": True})
market = client.markets.retrieve_by_slug("chiefs-super-bowl")
book = client.markets.book("chiefs-super-bowl")

const order = await client.orders.create({
  marketSlug: 'chiefs-super-bowl',
  intent: 'ORDER_INTENT_BUY_LONG',
  type: 'ORDER_TYPE_LIMIT',
  price: { value: '0.55', currency: 'USD' },
  quantity: 100,
  tif: 'TIME_IN_FORCE_GOOD_TILL_CANCEL',
});

order = client.orders.create({
    "marketSlug": "chiefs-super-bowl",
    "intent": "ORDER_INTENT_BUY_LONG",
    "type": "ORDER_TYPE_LIMIT",
    "price": {"value": "0.55", "currency": "USD"},
    "quantity": 100,
    "tif": "TIME_IN_FORCE_GOOD_TILL_CANCEL",
})

const balances = await client.account.balances();
const positions = await client.portfolio.positions();
const openOrders = await client.orders.list();

balances = client.account.balances()
positions = client.portfolio.positions()
open_orders = client.orders.list()

import {
  AuthenticationError,
  BadRequestError,
  NotFoundError,
  RateLimitError,
} from 'polymarket-us';

try {
  const order = await client.orders.create({ marketSlug: '...' });
} catch (error) {
  if (error instanceof AuthenticationError) {
    console.error('Invalid credentials');
  } else if (error instanceof BadRequestError) {
    console.error('Invalid parameters:', error.message);
  } else if (error instanceof RateLimitError) {
    console.error('Rate limited');
  } else if (error instanceof NotFoundError) {
    console.error('Not found');
  }
}

from polymarket_us import (
    AuthenticationError,
    BadRequestError,
    NotFoundError,
    RateLimitError,
    APITimeoutError,
    APIConnectionError,
)

try:
    order = client.orders.create({"marketSlug": "..."})
except AuthenticationError as e:
    print(f"Invalid credentials: {e.message}")
except BadRequestError as e:
    print(f"Invalid parameters: {e.message}")
except RateLimitError as e:
    print(f"Rate limited: {e.message}")
except NotFoundError as e:
    print(f"Not found: {e.message}")