> ## Documentation Index
> Fetch the complete documentation index at: https://api.synthesis.trade/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Copytrade

> Update a Polymarket copytrade configuration for a Polygon wallet.



## OpenAPI

````yaml /openapi.json put /api/v1/wallet/pol/{wallet_id}/copytrade/{copytrade_id}
openapi: 3.1.0
info:
  title: Synthesis API
  version: 1.0.0
  description: Unified prediction market API for Polymarket and Kalshi.
servers:
  - url: https://synthesis.trade
security: []
tags:
  - name: Projects
    description: Create and manage project accounts, sessions, and account API keys.
  - name: Accounts
    description: >-
      Authenticate and manage account-level sessions, account API keys, and
      public account preferences.
  - name: Markets
    description: Unified market discovery and analytics across Polymarket and Kalshi.
  - name: Polymarket
    description: Polymarket market data, prices, orderbooks, trades, and holders endpoints.
  - name: Kalshi
    description: Kalshi market data, events, history, leaderboard, and profile endpoints.
  - name: Wallets
    description: Wallet management routes. Each wallet supports multiple chains.
  - name: Polygon
    description: >-
      Polygon wallet routes for balances, orders, minting, redemption,
      withdrawals, and swaps.
  - name: Polygon Copytrades
    description: Polymarket copytrade configuration and management for Polygon wallets.
  - name: Solana
    description: >-
      Solana wallet routes used for Kalshi balances, KYC, orders, redemption,
      and withdrawals.
  - name: News
    description: News endpoints with market and event matching.
  - name: WebSockets
    description: >-
      Real-time streaming endpoints for orderbooks, trades, balances, and live
      data feeds.
paths:
  /api/v1/wallet/pol/{wallet_id}/copytrade/{copytrade_id}:
    put:
      tags:
        - Polygon Copytrades
      summary: Update Copytrade
      description: Update a Polymarket copytrade configuration for a Polygon wallet.
      operationId: update-polygon-copytrade
      parameters:
        - name: wallet_id
          in: path
          required: true
          schema:
            type: string
        - name: copytrade_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - target
                - mode
                - settings
              properties:
                target:
                  type: string
                  description: >-
                    Target Polygon address to track. Must be a valid address and
                    cannot equal the wallet address.
                mode:
                  type: string
                  description: '`COPY` or `COUNTER`.'
                settings:
                  type: object
                  required:
                    - filters
                    - buy
                    - sell
                  description: >-
                    Updated copytrade settings payload. Same structure as create
                    copytrade.
                  properties:
                    filters:
                      type: object
                      required:
                        - resolution
                        - price
                        - slippage
                        - labels
                        - exposure
                        - amount
                      properties:
                        resolution:
                          type: object
                          required:
                            - enabled
                            - within_seconds
                          properties:
                            enabled:
                              type: boolean
                            within_seconds:
                              type: integer
                              description: >-
                                Minimum seconds before market resolution. Must
                                be >= 0 when enabled.
                        price:
                          type: object
                          required:
                            - enabled
                          properties:
                            enabled:
                              type: boolean
                            min:
                              type: number
                              nullable: true
                              description: >-
                                Minimum price filter. Range: 0.001–0.999, up to
                                3 decimal places.
                            max:
                              type: number
                              nullable: true
                              description: >-
                                Maximum price filter. Range: 0.001–0.999, up to
                                3 decimal places.
                        slippage:
                          type: object
                          required:
                            - enabled
                            - max_cents
                          properties:
                            enabled:
                              type: boolean
                            max_cents:
                              type: number
                              description: >-
                                Maximum slippage in cents. Range: >0 to 100, up
                                to 1 decimal place.
                        labels:
                          type: object
                          required:
                            - enabled
                            - allow
                            - deny
                          properties:
                            enabled:
                              type: boolean
                            allow:
                              type: array
                              items:
                                type: string
                              description: >-
                                Allowed labels. Values: `crypto`, `sports`,
                                `united_states_politics`, `geopolitics`,
                                `mentions`, `economics`, `companies`, `tech`,
                                `culture`, `science`.
                            deny:
                              type: array
                              items:
                                type: string
                              description: Denied labels. Same allowed values as `allow`.
                        exposure:
                          type: object
                          required:
                            - enabled
                          properties:
                            enabled:
                              type: boolean
                            max_market:
                              type: number
                              nullable: true
                              description: >-
                                Maximum exposure per market in USDC. Must be >
                                0, up to 2 decimal places.
                            max_event:
                              type: number
                              nullable: true
                              description: >-
                                Maximum exposure per event in USDC. Must be > 0,
                                up to 2 decimal places.
                        amount:
                          type: object
                          required:
                            - enabled
                          properties:
                            enabled:
                              type: boolean
                            min:
                              type: number
                              nullable: true
                              description: >-
                                Minimum target trade amount in USDC. Must be >
                                0, up to 2 decimal places.
                            max:
                              type: number
                              nullable: true
                              description: >-
                                Maximum target trade amount in USDC. Must be >
                                0, up to 2 decimal places.
                    buy:
                      type: object
                      required:
                        - enabled
                        - insufficient_funds
                        - sizing
                        - total
                      properties:
                        enabled:
                          type: boolean
                        insufficient_funds:
                          type: string
                          enum:
                            - BUY_MAX
                            - SKIP
                          description: >-
                            `BUY_MAX` to buy with available funds, `SKIP` to
                            skip the trade.
                        sizing:
                          type: object
                          required:
                            - type
                          description: Buy sizing strategy. Discriminated by `type`.
                          oneOf:
                            - title: Fixed Amount
                              type: object
                              required:
                                - type
                                - amount
                              properties:
                                type:
                                  type: string
                                  const: FIXED
                                amount:
                                  type: number
                                  description: >-
                                    Fixed USDC amount per trade. Must be >= 1,
                                    up to 2 decimal places.
                            - title: Percentage of Trade
                              type: object
                              required:
                                - type
                                - percent
                              properties:
                                type:
                                  type: string
                                  const: PERCENTAGE
                                percent:
                                  type: number
                                  description: >-
                                    Fraction of the target's trade size to copy.
                                    Range: 0.01–1.0.
                            - title: Percentage of Balance
                              type: object
                              required:
                                - type
                                - percent
                                - source
                              properties:
                                type:
                                  type: string
                                  const: BALANCE
                                percent:
                                  type: number
                                  description: 'Fraction of balance to use. Range: 0.01–1.0.'
                                source:
                                  type: string
                                  enum:
                                    - WALLET
                                    - TOTAL
                                  description: >-
                                    `WALLET` for wallet balance, `TOTAL` for
                                    total allocation (requires `total.type` =
                                    `FIXED`).
                        total:
                          type: object
                          required:
                            - type
                          description: Total buy budget. Discriminated by `type`.
                          oneOf:
                            - title: No Budget Limit
                              type: object
                              required:
                                - type
                              properties:
                                type:
                                  type: string
                                  const: NONE
                            - title: Fixed Budget
                              type: object
                              required:
                                - type
                                - amount
                              properties:
                                type:
                                  type: string
                                  const: FIXED
                                amount:
                                  type: number
                                  description: >-
                                    Total USDC budget. Must be >= 0.01, up to 2
                                    decimal places.
                    sell:
                      type: object
                      required:
                        - enabled
                        - insufficient_shares
                        - sizing
                        - take_profit
                      properties:
                        enabled:
                          type: boolean
                        insufficient_shares:
                          type: string
                          enum:
                            - SELL_MAX
                            - SKIP
                          description: >-
                            `SELL_MAX` to sell available shares, `SKIP` to skip
                            the trade.
                        sizing:
                          type: object
                          required:
                            - type
                          description: Sell sizing strategy. Discriminated by `type`.
                          oneOf:
                            - title: Fixed Shares
                              type: object
                              required:
                                - type
                                - amount
                              properties:
                                type:
                                  type: string
                                  const: FIXED
                                amount:
                                  type: number
                                  description: >-
                                    Fixed number of shares to sell. Must be >=
                                    0.01, up to 2 decimal places.
                            - title: Percentage of Shares
                              type: object
                              required:
                                - type
                                - percent
                              properties:
                                type:
                                  type: string
                                  const: PERCENTAGE
                                percent:
                                  type: number
                                  description: >-
                                    Fraction of held shares to sell. Range:
                                    0.01–1.0.
                        take_profit:
                          type: object
                          required:
                            - enabled
                          properties:
                            enabled:
                              type: boolean
                            percent:
                              type: number
                              nullable: true
                              description: >-
                                Take profit percentage. Range: 1.0–10000.0, up
                                to 2 decimal places. Required when enabled.
      responses:
        '200':
          description: Polygon copytrade updated
          content:
            application/json:
              example:
                success: true
                response:
                  copytrade_id: 01234567-89ab-cdef-0123-456789abcdef
                  target: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e'
                  mode: COPY
                  status: ACTIVE
      security:
        - AccountApiKey: []
        - AccountSession: []
components:
  securitySchemes:
    AccountApiKey:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Account secret API key.
    AccountSession:
      type: http
      scheme: bearer
      description: Account session token.

````