clob-client-sdks 5.3.4

package/dist/types.d.ts

@@ -0,0 +1,667 @@
+import type { SignatureType, SignedOrder } from "@polymarket/order-utils";
+export interface ApiKeyCreds {
+    key: string;
+    secret: string;
+    passphrase: string;
+}
+export interface ApiKeyRaw {
+    apiKey: string;
+    secret: string;
+    passphrase: string;
+}
+export interface ReadonlyApiKeyResponse {
+    apiKey: string;
+}
+export interface L2HeaderArgs {
+    method: string;
+    requestPath: string;
+    body?: string;
+}
+export type SimpleHeaders = Record<string, string | number | boolean>;
+export interface L1PolyHeader extends SimpleHeaders {
+    POLY_ADDRESS: string;
+    POLY_SIGNATURE: string;
+    POLY_TIMESTAMP: string;
+    POLY_NONCE: string;
+}
+export interface L2PolyHeader extends SimpleHeaders {
+    POLY_ADDRESS: string;
+    POLY_SIGNATURE: string;
+    POLY_TIMESTAMP: string;
+    POLY_API_KEY: string;
+    POLY_PASSPHRASE: string;
+}
+export interface L2WithBuilderHeader extends L2PolyHeader {
+    POLY_BUILDER_API_KEY: string;
+    POLY_BUILDER_TIMESTAMP: string;
+    POLY_BUILDER_PASSPHRASE: string;
+    POLY_BUILDER_SIGNATURE: string;
+}
+export declare enum Side {
+    BUY = "BUY",
+    SELL = "SELL"
+}
+export declare enum OrderType {
+    GTC = "GTC",
+    FOK = "FOK",
+    GTD = "GTD",
+    FAK = "FAK"
+}
+export interface PostOrdersArgs {
+    order: SignedOrder;
+    orderType: OrderType;
+    postOnly?: boolean;
+}
+export interface NewOrder<T extends OrderType> {
+    readonly order: {
+        readonly salt: number;
+        readonly maker: string;
+        readonly signer: string;
+        readonly taker: string;
+        readonly tokenId: string;
+        readonly makerAmount: string;
+        readonly takerAmount: string;
+        readonly expiration: string;
+        readonly nonce: string;
+        readonly feeRateBps: string;
+        readonly side: Side;
+        readonly signatureType: SignatureType;
+        readonly signature: string;
+    };
+    readonly owner: string;
+    readonly orderType: T;
+    readonly deferExec: boolean;
+    readonly postOnly?: boolean;
+}
+export interface UserOrder {
+    /**
+     * TokenID of the Conditional token asset being traded
+     */
+    tokenID: string;
+    /**
+     * Price used to create the order
+     */
+    price: number;
+    /**
+     * Size in terms of the ConditionalToken
+     */
+    size: number;
+    /**
+     * Side of the order
+     */
+    side: Side;
+    /**
+     * Fee rate, in basis points, charged to the order maker, charged on proceeds
+     */
+    feeRateBps?: number;
+    /**
+     * Nonce used for onchain cancellations
+     */
+    nonce?: number;
+    /**
+     * Timestamp after which the order is expired.
+     */
+    expiration?: number;
+    /**
+     * Address of the order taker. The zero address is used to indicate a public order
+     */
+    taker?: string;
+}
+export interface UserMarketOrder {
+    /**
+     * TokenID of the Conditional token asset being traded
+     */
+    tokenID: string;
+    /**
+     * Price used to create the order
+     * If it is not present the market price will be used.
+     */
+    price?: number;
+    /**
+     * BUY orders: $$$ Amount to buy
+     * SELL orders: Shares to sell
+     */
+    amount: number;
+    /**
+     * Side of the order
+     */
+    side: Side;
+    /**
+     * Fee rate, in basis points, charged to the order maker, charged on proceeds
+     */
+    feeRateBps?: number;
+    /**
+     * Nonce used for onchain cancellations
+     */
+    nonce?: number;
+    /**
+     * Address of the order taker. The zero address is used to indicate a public order
+     */
+    taker?: string;
+    /**
+     * Specifies the type of order execution:
+     * - FOK (Fill or Kill): The order must be filled entirely or not at all.
+     * - FAK (Fill and Kill): The order can be partially filled, and any unfilled portion is canceled.
+     */
+    orderType?: OrderType.FOK | OrderType.FAK;
+}
+export interface OrderPayload {
+    orderID: string;
+}
+export interface ApiKeysResponse {
+    apiKeys: ApiKeyCreds[];
+}
+export interface BanStatus {
+    closed_only: boolean;
+}
+export interface OrderResponse {
+    success: boolean;
+    errorMsg: string;
+    orderID: string;
+    transactionsHashes: string[];
+    status: string;
+    takingAmount: string;
+    makingAmount: string;
+}
+export interface OpenOrder {
+    id: string;
+    status: string;
+    owner: string;
+    maker_address: string;
+    market: string;
+    asset_id: string;
+    side: string;
+    original_size: string;
+    size_matched: string;
+    price: string;
+    associate_trades: string[];
+    outcome: string;
+    created_at: number;
+    expiration: string;
+    order_type: string;
+}
+export type OpenOrdersResponse = OpenOrder[];
+export interface TradeParams {
+    id?: string;
+    maker_address?: string;
+    market?: string;
+    asset_id?: string;
+    before?: string;
+    after?: string;
+}
+export interface OpenOrderParams {
+    id?: string;
+    market?: string;
+    asset_id?: string;
+}
+export interface MakerOrder {
+    order_id: string;
+    owner: string;
+    maker_address: string;
+    matched_amount: string;
+    price: string;
+    fee_rate_bps: string;
+    asset_id: string;
+    outcome: string;
+    side: Side;
+}
+export interface Trade {
+    id: string;
+    taker_order_id: string;
+    market: string;
+    asset_id: string;
+    side: Side;
+    size: string;
+    fee_rate_bps: string;
+    price: string;
+    status: string;
+    match_time: string;
+    last_update: string;
+    outcome: string;
+    bucket_index: number;
+    owner: string;
+    maker_address: string;
+    maker_orders: MakerOrder[];
+    transaction_hash: string;
+    trader_side: "TAKER" | "MAKER";
+}
+export declare enum Chain {
+    POLYGON = 137,
+    AMOY = 80002
+}
+export interface MarketPrice {
+    t: number;
+    p: number;
+}
+export interface PriceHistoryFilterParams {
+    market?: string;
+    startTs?: number;
+    endTs?: number;
+    fidelity?: number;
+    interval?: PriceHistoryInterval;
+}
+export declare enum PriceHistoryInterval {
+    MAX = "max",
+    ONE_WEEK = "1w",
+    ONE_DAY = "1d",
+    SIX_HOURS = "6h",
+    ONE_HOUR = "1h"
+}
+export interface DropNotificationParams {
+    ids: string[];
+}
+export interface Notification {
+    type: number;
+    owner: string;
+    payload: any;
+}
+export interface OrderMarketCancelParams {
+    market?: string;
+    asset_id?: string;
+}
+export interface OrderBookSummary {
+    market: string;
+    asset_id: string;
+    timestamp: string;
+    bids: OrderSummary[];
+    asks: OrderSummary[];
+    min_order_size: string;
+    tick_size: string;
+    neg_risk: boolean;
+    last_trade_price: string;
+    hash: string;
+}
+export interface OrderSummary {
+    price: string;
+    size: string;
+}
+export declare enum AssetType {
+    COLLATERAL = "COLLATERAL",
+    CONDITIONAL = "CONDITIONAL"
+}
+export interface BalanceAllowanceParams {
+    asset_type: AssetType;
+    token_id?: string;
+}
+export interface BalanceAllowanceResponse {
+    balance: string;
+    allowance: string;
+}
+export interface OrderScoringParams {
+    order_id: string;
+}
+export interface OrderScoring {
+    scoring: boolean;
+}
+export interface OrdersScoringParams {
+    orderIds: string[];
+}
+export type OrdersScoring = {
+    [orderId in string]: boolean;
+};
+export type CreateOrderOptions = {
+    tickSize: TickSize;
+    negRisk?: boolean;
+};
+export type TickSize = "0.1" | "0.01" | "0.001" | "0.0001";
+export interface RoundConfig {
+    readonly price: number;
+    readonly size: number;
+    readonly amount: number;
+}
+export interface TickSizes {
+    [tokenId: string]: TickSize;
+}
+export interface NegRisk {
+    [tokenId: string]: boolean;
+}
+export interface FeeRates {
+    [tokenId: string]: number;
+}
+export interface PaginationPayload {
+    readonly limit: number;
+    readonly count: number;
+    readonly next_cursor: string;
+    readonly data: any[];
+}
+export interface MarketTradeEvent {
+    event_type: string;
+    market: {
+        condition_id: string;
+        asset_id: string;
+        question: string;
+        icon: string;
+        slug: string;
+    };
+    user: {
+        address: string;
+        username: string;
+        profile_picture: string;
+        optimized_profile_picture: string;
+        pseudonym: string;
+    };
+    side: Side;
+    size: string;
+    fee_rate_bps: string;
+    price: string;
+    outcome: string;
+    outcome_index: number;
+    transaction_hash: string;
+    timestamp: string;
+}
+export interface BookParams {
+    token_id: string;
+    side: Side;
+}
+export interface UserEarning {
+    date: string;
+    condition_id: string;
+    asset_address: string;
+    maker_address: string;
+    earnings: number;
+    asset_rate: number;
+}
+export interface TotalUserEarning {
+    date: string;
+    asset_address: string;
+    maker_address: string;
+    earnings: number;
+    asset_rate: number;
+}
+export interface RewardsPercentages {
+    [market: string]: number;
+}
+export interface Token {
+    token_id: string;
+    outcome: string;
+    price: number;
+}
+export interface RewardsConfig {
+    asset_address: string;
+    start_date: string;
+    end_date: string;
+    rate_per_day: number;
+    total_rewards: number;
+}
+export interface MarketReward {
+    condition_id: string;
+    question: string;
+    market_slug: string;
+    event_slug: string;
+    image: string;
+    rewards_max_spread: number;
+    rewards_min_size: number;
+    tokens: Token[];
+    rewards_config: RewardsConfig[];
+}
+export interface Earning {
+    asset_address: string;
+    earnings: number;
+    asset_rate: number;
+}
+export interface BuilderApiKey {
+    key: string;
+    secret: string;
+    passphrase: string;
+}
+export interface BuilderApiKeyResponse {
+    key: string;
+    createdAt?: string;
+    revokedAt?: string;
+}
+export interface UserRewardsEarning {
+    condition_id: string;
+    question: string;
+    market_slug: string;
+    event_slug: string;
+    image: string;
+    rewards_max_spread: number;
+    rewards_min_size: number;
+    market_competitiveness: number;
+    tokens: Token[];
+    rewards_config: RewardsConfig[];
+    maker_address: string;
+    earning_percentage: number;
+    earnings: Earning[];
+}
+export interface BuilderTrade {
+    id: string;
+    tradeType: string;
+    takerOrderHash: string;
+    builder: string;
+    market: string;
+    assetId: string;
+    side: string;
+    size: string;
+    sizeUsdc: string;
+    price: string;
+    status: string;
+    outcome: string;
+    outcomeIndex: number;
+    owner: string;
+    maker: string;
+    transactionHash: string;
+    matchTime: string;
+    bucketIndex: number;
+    fee: string;
+    feeUsdc: string;
+    err_msg?: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export interface CancelRfqRequestParams {
+    requestId: string;
+}
+export interface CreateRfqRequestParams {
+    assetIn: string;
+    assetOut: string;
+    amountIn: string;
+    amountOut: string;
+    userType: number;
+}
+export interface RfqQuoteParams {
+    requestId: string;
+    assetIn: string;
+    assetOut: string;
+    amountIn: string;
+    amountOut: string;
+    userType: number;
+}
+export interface CreateRfqQuoteParams {
+    requestId: string;
+    assetIn: string;
+    assetOut: string;
+    amountIn: string;
+    amountOut: string;
+}
+export interface CancelRfqQuoteParams {
+    quoteId: string;
+}
+export interface AcceptQuoteParams {
+    requestId: string;
+    quoteId: string;
+    expiration: number;
+}
+export interface ApproveOrderParams {
+    requestId: string;
+    quoteId: string;
+    expiration: number;
+}
+export type RfqListState = "active" | "inactive";
+export type RfqSortDir = "asc" | "desc";
+export type RfqRequestsSortBy = "price" | "expiry" | "size" | "created";
+export type RfqQuotesSortBy = "price" | "expiry" | "created";
+export interface GetRfqQuotesParams {
+    /**
+     * Pagination cursor, base64-encoded integer (default "MA==" → 0)
+     */
+    offset?: string;
+    /**
+     * Integer (default 50, max 100)
+     */
+    limit?: number;
+    /**
+     * Optional; active | inactive (if omitted: no state filter)
+     */
+    state?: RfqListState;
+    /**
+     * Repeatable (UUIDs; invalid UUIDs are dropped server-side)
+     */
+    quoteIds?: string[];
+    /**
+     * Repeatable (UUIDs; invalid UUIDs are dropped server-side)
+     */
+    requestIds?: string[];
+    /**
+     * Repeatable (condition ids; must be 0x + 64 hex)
+     */
+    markets?: string[];
+    /**
+     * float (token size)
+     */
+    sizeMin?: number;
+    /**
+     * float (token size)
+     */
+    sizeMax?: number;
+    /**
+     * float (USDC size)
+     */
+    sizeUsdcMin?: number;
+    /**
+     * float (USDC size)
+     */
+    sizeUsdcMax?: number;
+    priceMin?: number;
+    priceMax?: number;
+    /**
+     * price | expiry | created (default created)
+     */
+    sortBy?: RfqQuotesSortBy;
+    /**
+     * asc | desc (default asc)
+     */
+    sortDir?: RfqSortDir;
+}
+export interface GetRfqBestQuoteParams {
+    requestId?: string;
+}
+export type RfqUserOrder = Pick<UserOrder, "price" | "size" | "side" | "tokenID">;
+export type RfqUserQuote = RfqUserOrder & {
+    requestId: string;
+};
+export interface GetRfqRequestsParams {
+    /**
+     * Pagination cursor, base64-encoded integer (default "MA==" → 0)
+     */
+    offset?: string;
+    /**
+     * Integer (default 50, max 100)
+     */
+    limit?: number;
+    /**
+     * Optional; active | inactive (if omitted: no state filter)
+     */
+    state?: RfqListState;
+    /**
+     * Repeatable (UUIDs; invalid UUIDs are dropped server-side)
+     */
+    requestIds?: string[];
+    /**
+     * Repeatable (condition ids; must be 0x + 64 hex)
+     */
+    markets?: string[];
+    /**
+     * float (token size)
+     */
+    sizeMin?: number;
+    /**
+     * float (token size)
+     */
+    sizeMax?: number;
+    /**
+     * float (USDC size)
+     */
+    sizeUsdcMin?: number;
+    /**
+     * float (USDC size)
+     */
+    sizeUsdcMax?: number;
+    priceMin?: number;
+    priceMax?: number;
+    /**
+     * price | expiry | size | created (default created)
+     */
+    sortBy?: RfqRequestsSortBy;
+    /**
+     * asc | desc (default asc)
+     */
+    sortDir?: RfqSortDir;
+}
+export interface RfqPaginatedResponse<T> {
+    readonly data: T[];
+    readonly next_cursor: string;
+    readonly limit: number;
+    readonly count: number;
+    readonly total_count?: number;
+}
+export interface RfqRequest {
+    readonly requestId: string;
+    readonly userAddress: string;
+    readonly proxyAddress: string;
+    readonly token: string;
+    readonly complement: string;
+    readonly condition: string;
+    readonly side: string;
+    readonly sizeIn: string;
+    readonly sizeOut: string;
+    readonly price: number;
+    readonly acceptedQuoteId: string;
+    readonly state: string;
+    readonly expiry: Date;
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+}
+export declare enum RfqMatchType {
+    COMPLEMENTARY = "COMPLEMENTARY",
+    MERGE = "MERGE",
+    MINT = "MINT"
+}
+export interface RfqQuote {
+    readonly quoteId: string;
+    readonly requestId: string;
+    readonly userAddress: string;
+    readonly proxyAddress: string;
+    readonly complement: string;
+    readonly condition: string;
+    readonly token: string;
+    readonly side: string;
+    readonly sizeIn: string;
+    readonly sizeOut: string;
+    readonly price: number;
+    readonly state: string;
+    readonly expiry: Date;
+    readonly matchType: string;
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+}
+export type RfqRequestsResponse = RfqPaginatedResponse<RfqRequest>;
+export type RfqQuotesResponse = RfqPaginatedResponse<RfqQuote>;
+export interface RfqRequestResponse {
+    readonly requestId: string;
+    readonly error?: string;
+}
+export interface RfqQuoteResponse {
+    readonly quoteId: string;
+    readonly error?: string;
+}
+export interface HeartbeatResponse {
+    readonly heartbeat_id: string;
+    readonly error?: string;
+}
+export interface RfqRequestOrderCreationPayload {
+    readonly token: string;
+    readonly side: Side;
+    readonly size: string;
+    readonly price: number;
+}

package/dist/types.js

@@ -0,0 +1,37 @@
+export var Side;
+(function (Side) {
+    Side["BUY"] = "BUY";
+    Side["SELL"] = "SELL";
+})(Side || (Side = {}));
+export var OrderType;
+(function (OrderType) {
+    OrderType["GTC"] = "GTC";
+    OrderType["FOK"] = "FOK";
+    OrderType["GTD"] = "GTD";
+    OrderType["FAK"] = "FAK";
+})(OrderType || (OrderType = {}));
+export var Chain;
+(function (Chain) {
+    Chain[Chain["POLYGON"] = 137] = "POLYGON";
+    Chain[Chain["AMOY"] = 80002] = "AMOY";
+})(Chain || (Chain = {}));
+export var PriceHistoryInterval;
+(function (PriceHistoryInterval) {
+    PriceHistoryInterval["MAX"] = "max";
+    PriceHistoryInterval["ONE_WEEK"] = "1w";
+    PriceHistoryInterval["ONE_DAY"] = "1d";
+    PriceHistoryInterval["SIX_HOURS"] = "6h";
+    PriceHistoryInterval["ONE_HOUR"] = "1h";
+})(PriceHistoryInterval || (PriceHistoryInterval = {}));
+export var AssetType;
+(function (AssetType) {
+    AssetType["COLLATERAL"] = "COLLATERAL";
+    AssetType["CONDITIONAL"] = "CONDITIONAL";
+})(AssetType || (AssetType = {}));
+export var RfqMatchType;
+(function (RfqMatchType) {
+    RfqMatchType["COMPLEMENTARY"] = "COMPLEMENTARY";
+    RfqMatchType["MERGE"] = "MERGE";
+    RfqMatchType["MINT"] = "MINT";
+})(RfqMatchType || (RfqMatchType = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAoDA,MAAM,CAAN,IAAY,IAGX;AAHD,WAAY,IAAI;IACZ,mBAAW,CAAA;IACX,qBAAa,CAAA;AACjB,CAAC,EAHW,IAAI,KAAJ,IAAI,QAGf;AAED,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACjB,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,wBAAW,CAAA;AACf,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB;AAoND,MAAM,CAAN,IAAY,KAGX;AAHD,WAAY,KAAK;IACb,yCAAa,CAAA;IACb,qCAAY,CAAA;AAChB,CAAC,EAHW,KAAK,KAAL,KAAK,QAGhB;AAeD,MAAM,CAAN,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,mCAAW,CAAA;IACX,uCAAe,CAAA;IACf,sCAAc,CAAA;IACd,wCAAgB,CAAA;IAChB,uCAAe,CAAA;AACnB,CAAC,EANW,oBAAoB,KAApB,oBAAoB,QAM/B;AAoCD,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACjB,sCAAyB,CAAA;IACzB,wCAA2B,CAAA;AAC/B,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAsYD,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACpB,+CAA+B,CAAA;IAC/B,+BAAe,CAAA;IACf,6BAAa,CAAA;AACjB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}

package/dist/utilities.d.ts

@@ -0,0 +1,16 @@
+import type { SignedOrder } from "@polymarket/order-utils";
+import { OrderType } from "./types.ts";
+import type { NewOrder, OrderBookSummary, TickSize } from "./types.ts";
+export declare function orderToJson<T extends OrderType>(order: SignedOrder, owner: string, orderType: T, deferExec?: boolean, postOnly?: boolean): NewOrder<T>;
+export declare const roundNormal: (num: number, decimals: number) => number;
+export declare const roundDown: (num: number, decimals: number) => number;
+export declare const roundUp: (num: number, decimals: number) => number;
+export declare const decimalPlaces: (num: number) => number;
+/**
+ * Calculates the hash for the given orderbook
+ * @param orderbook
+ * @returns
+ */
+export declare const generateOrderBookSummaryHash: (orderbook: OrderBookSummary) => Promise<string>;
+export declare const isTickSizeSmaller: (a: TickSize, b: TickSize) => boolean;
+export declare const priceValid: (price: number, tickSize: TickSize) => boolean;