feat: add market order preparation workflow

Author: cesarenaldi

AGENTS.md

@@ -38,6 +38,8 @@
 
 - Prefer `type` over `interface` unless an interface is clearly needed, such as when a class implements it or declaration extensibility is a deliberate requirement.
 - Prefer function declarations over arrow functions unless there is a clear reason to use an arrow function.
+- When a request, params, or options object shape is specific to a single function, colocate that type directly above the function declaration.
+- Treat property-access-derived types like `SecureClient['signatureType']` as a code smell in most cases. Prefer a named domain type when the value is part of the public or shared model.
 - Prefer simple, local code. Accept small duplication when it keeps logic easier to read.
 - Introduce helpers only when they meaningfully improve reuse, safety, or readability. Helper names should reflect their real behavior; otherwise inline or rename them.
 - Shape abstractions around real supported workflows and current platform behavior, not generic completeness. Add breadth only when a concrete use case requires it.

docs/sdk-direction.md

@@ -27,6 +27,8 @@ The first shipping target is `@polymarket/client`. Its job is to make Polymarket
 
 - In this case, make CLOB responses use camelCased fields.
 - Add a cache layer for `tickSize`, fee bps, and `negRisk` metadata.
+- Consider moving `SignedOrder` into `packages/client/src/types.ts` so it is easier to reuse across order actions and wallet helpers.
+- Revisit whether the Gamma `GET /markets` `active` flag should be modeled in the SDK, since it is accepted in practice but omitted from the current OpenAPI contract and current client request type.
 
 ## Package Direction
 

packages/bindings/src/clob/account.ts

@@ -95,7 +95,7 @@ export enum AssetType {
   CONDITIONAL = 'CONDITIONAL',
 }
 
-export const AssetTypeSchema = z.nativeEnum(AssetType);
+export const AssetTypeSchema = z.enum(AssetType);
 
 export const BalanceAllowanceResponseSchema = z.object({
   allowances: z.record(z.string(), z.string()),

packages/bindings/src/clob/index.ts

@@ -2,6 +2,9 @@ export * from './account';
 export * from './api-key';
 export * from './fee-rate';
 export * from './neg-risk';
+export * from './order';
+export * from './order-book';
+export * from './order-response';
 export * from './pagination';
 export * from './signature-type';
 export * from './tick-size';

packages/bindings/src/clob/order-book.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+
+export const OrderBookLevelSchema = z.looseObject({
+  price: z.string(),
+  size: z.string(),
+});
+
+export const OrderBookSchema = z.looseObject({
+  market: z.string(),
+  asset_id: z.string(),
+  timestamp: z.string().nullish(),
+  bids: z.array(OrderBookLevelSchema),
+  asks: z.array(OrderBookLevelSchema),
+  min_order_size: z.string(),
+  tick_size: z.string(),
+  neg_risk: z.boolean(),
+  last_trade_price: z.string().nullish(),
+  hash: z.string(),
+});
+
+export const FetchOrderBookResponseSchema = OrderBookSchema;
+
+export type OrderBookLevel = z.infer<typeof OrderBookLevelSchema>;
+export type OrderBook = z.infer<typeof OrderBookSchema>;
+export type FetchOrderBookResponse = z.infer<
+  typeof FetchOrderBookResponseSchema
+>;

packages/bindings/src/clob/order-response.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+
+export const OrderResponseSchema = z.object({
+  errorMsg: z.string(),
+  makingAmount: z.string(),
+  orderID: z.string(),
+  status: z.string(),
+  success: z.boolean(),
+  takingAmount: z.string(),
+  transactionsHashes: z.array(z.string()),
+});
+
+export type OrderResponse = z.infer<typeof OrderResponseSchema>;

packages/bindings/src/clob/order.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+
+export enum OrderSide {
+  BUY = 'BUY',
+  SELL = 'SELL',
+}
+
+export enum OrderType {
+  GTC = 'GTC',
+  FOK = 'FOK',
+  GTD = 'GTD',
+  FAK = 'FAK',
+}
+
+export const OrderSideSchema = z.enum(OrderSide);
+export const OrderTypeSchema = z.enum(OrderType);

packages/bindings/src/clob/signature-type.ts

@@ -1,8 +1,19 @@
 import { z } from 'zod';
 
 export enum SignatureType {
+  /**
+   * ECDSA EIP712 signatures signed by EOAs
+   */
   EOA = 0,
+
+  /**
+   * EIP712 signatures signed by EOAs that own Polymarket Proxy wallets
+   */
   POLY_PROXY = 1,
+
+  /**
+   * EIP712 signatures signed by EOAs that own Polymarket Gnosis safes
+   */
   POLY_GNOSIS_SAFE = 2,
 }
 

packages/bindings/src/clob/tick-size.ts

@@ -1,7 +1,8 @@
 import { z } from 'zod';
+import { TickSizeValueSchema } from '../shared';
 
 export const TickSizeSchema = z.looseObject({
-  minimum_tick_size: z.number(),
+  minimum_tick_size: TickSizeValueSchema,
 });
 
 export const FetchTickSizeResponseSchema = TickSizeSchema;

packages/bindings/src/gamma/market.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { MarketIdSchema } from '../shared';
+import { MarketIdSchema, TickSizeValueSchema } from '../shared';
 import {
   CategoryReferenceSchema,
   ClobRewardsSchema,
@@ -74,7 +74,7 @@ export const MarketSchema = z.looseObject({
   questionID: z.string().nullish(),
   umaEndDate: z.string().nullish(),
   enableOrderBook: z.boolean().nullish(),
-  orderPriceMinTickSize: z.number().nullish(),
+  orderPriceMinTickSize: TickSizeValueSchema.nullish(),
   orderMinSize: z.number().nullish(),
   umaResolutionStatus: z.string().nullish(),
   curationOrder: z.number().int().nullish(),