> ## Documentation Index > Fetch the complete documentation index at: https://docs.carboncopy.inc/llms.txt > Use this file to discover all available pages before exploring further. # Follow a trader > Start copy-trading a new wallet. Returns `409 Conflict` if already following. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/portfolio/traders openapi: 3.1.0 info: title: Carbon Copy API version: 2.0.0 description: >- Programmatic access to Carbon Copy's Polymarket copy-trading platform. Follow traders, manage your portfolio, and automate your prediction market strategy. contact: name: Carbon Copy Support email: support@carboncopy.inc url: https://carboncopy.inc servers: - url: https://carboncopy.inc description: Production security: [] tags: - name: Health description: Service health and status. - name: Portfolio description: Portfolio summary, positions, trade history, and P&L. - name: Follow Management description: >- Follow, configure, and manage the traders you copy. All routes live under `/portfolio/traders`. - name: Trader Discovery description: Search and filter traders on the platform. Routes under `/traders`. - name: Orders description: Inspect orders placed by your copy-trading bot. - name: Markets description: Market data — prices and token info. - name: Account description: Your Carbon Copy account information. paths: /api/v1/portfolio/traders: post: tags: - Follow Management summary: Follow a trader description: >- Start copy-trading a new wallet. Returns `409 Conflict` if already following. operationId: followTrader requestBody: required: true content: application/json: schema: type: object required: - walletAddress - copyPercentage properties: walletAddress: type: string example: 0xAbCd1234... copyPercentage: type: number minimum: 0 maximum: 100 example: 25 maxCopyAmount: type: number description: Max USDC per trade. Omit for no cap. example: 500 notificationsEnabled: type: boolean default: true responses: '201': description: Trader followed. content: application/json: schema: $ref: '#/components/schemas/TraderDetail' '400': description: Invalid request. content: application/json: schema: $ref: '#/components/schemas/Error' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '409': description: Already following this trader. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: conflict message: You are already following this trader. '429': $ref: '#/components/responses/RateLimited' security: - ApiKeyAuth: [] components: schemas: TraderDetail: allOf: - $ref: '#/components/schemas/TraderSummary' - type: object properties: notificationsEnabled: type: boolean description: Whether notifications are enabled for this trader's activity. followedAt: type: integer description: Unix timestamp (ms) when you started following this trader. example: 1741500000000 recentTrades: type: array description: The 10 most recent trades by this trader. items: $ref: '#/components/schemas/CopyTrade' Error: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string enum: - bad_request - unauthorized - forbidden - not_found - method_not_allowed - conflict - quota_exceeded - rate_limited - internal_error message: type: string description: Human-readable description of the error. TraderSummary: type: object required: - walletAddress - copyTradingEnabled - copyPercentage properties: walletAddress: type: string description: Trader's Ethereum wallet address. example: 0xAbCd1234... username: type: - string - 'null' description: Trader's display name. example: sharptrader copyTradingEnabled: type: boolean description: '`true` if copy trading is currently active for this trader.' copyPercentage: type: number minimum: 0 maximum: 100 description: Percentage of each trade to copy. example: 25 maxCopyAmount: type: - number - 'null' description: Maximum USDC to deploy per copied trade. `null` means no cap. example: 500 totalCopied: type: integer description: Total number of trades copied from this trader. example: 14 pnl: type: number description: P&L in USDC from trades copied from this trader. example: 128.4 CopyTrade: type: object required: - id - traderWallet - marketId - side - amount - status - createdAt properties: id: type: string example: k17abc123def456 traderWallet: type: string example: 0xAbCd1234... marketId: type: string example: 0x1234abcd... marketQuestion: type: - string - 'null' example: Will BTC exceed $100k by end of 2025? side: type: string enum: - 'YES' - 'NO' description: Which outcome was purchased. amount: type: number description: USDC amount deployed. example: 50 price: type: number description: Average fill price (0–1). example: 0.62 pnl: type: number description: Realised P&L in USDC. `0` if not yet realized. example: 12.5 status: type: string enum: - open - executed - filled - resolved_win - resolved_loss - cancelled description: Current status of this copy trade. createdAt: type: integer description: Unix timestamp (ms). example: 1741550000000 responses: Unauthorized: description: Missing or invalid authentication credentials. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: unauthorized message: Invalid or missing API key. Forbidden: description: Authenticated but insufficient permissions (wrong scope). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: forbidden message: This key does not have the required scope. RateLimited: description: Too many requests. Back off and retry. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: rate_limited message: Rate limit exceeded. Retry after 30 seconds. securitySchemes: ApiKeyAuth: type: http scheme: bearer description: >- API key in the format `cc_<64 hex characters>`. Obtain from the Dashboard under Settings → API Keys. ````