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

# Update Recurring Buy

> Recurring buys that automatically purchase an asset on a schedule —
this is the **DCA / scheduled** trade flow. For instant one-shot
trades, use the swaps endpoints instead.

Set a fixed AUD amount, an asset, and a cadence, and the platform will
place the buy at each scheduled time. Changing the cadence resets the
next run to the current moment so the new schedule starts immediately,
unless a specific start time is provided.



## OpenAPI

````yaml /openapi.json put /api/private/broker/schedules/{id}/
openapi: 3.0.3
info:
  title: Digital Surge API
  version: '2.0'
  description: >-
    Digital Surge is an Australian cryptocurrency exchange. This API provides
    programmatic access to your account: live AUD pricing for hundreds of
    assets, instant swaps, recurring buys, price triggers, portfolio balances,
    transaction history, and crypto withdrawals.


    **Authentication** — create an API key in the Digital Surge app under
    *Account Settings → API Keys* and send it with every request:
    `Authorization: Bearer <your-api-key>`. Read-only and read & write keys are
    available.


    **Guides and interactive documentation** — https://digitalsurge.com.au/docs


    **AI agents** — connect via the Digital Surge MCP server:
    https://mcp.digitalsurge.com.au/mcp
servers:
  - url: https://app.digitalsurge.com.au
    description: Production
security: []
tags:
  - name: Public
    description: Unauthenticated endpoints — market data, asset info, pricing
  - name: Private
    description: Authenticated endpoints — trading, portfolio, account management
paths:
  /api/private/broker/schedules/{id}/:
    put:
      tags:
        - Private
      summary: Update Recurring Buy
      description: |-
        Recurring buys that automatically purchase an asset on a schedule —
        this is the **DCA / scheduled** trade flow. For instant one-shot
        trades, use the swaps endpoints instead.

        Set a fixed AUD amount, an asset, and a cadence, and the platform will
        place the buy at each scheduled time. Changing the cadence resets the
        next run to the current moment so the new schedule starts immediately,
        unless a specific start time is provided.
      operationId: private_broker_schedules_update
      parameters:
        - in: path
          name: id
          schema:
            type: integer
          description: A unique integer value identifying this Recurring Trade Schedule.
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecurringTradeScheduleRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/RecurringTradeScheduleRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/RecurringTradeScheduleRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecurringTradeSchedule'
          description: ''
      security:
        - bearerAuth: []
components:
  schemas:
    RecurringTradeScheduleRequest:
      type: object
      description: >-
        A recurring buy (DCA) schedule: automatically buys a set amount of an
        asset at a regular interval.
      properties:
        asset:
          type: string
          minLength: 1
        start:
          type: string
          format: date-time
        quantity:
          type: string
          format: decimal
          description: >-
            Amount to trade at each recurrence. When direction = BUY_ASSET, this
            is the AUD amount to spend buying the asset; when direction =
            SELL_ASSET, this is the quantity of the asset (in its native units)
            to sell.
        direction:
          allOf:
            - $ref: '#/components/schemas/TradeDirectionEnum'
          description: >-
            Direction of the recurring trade against AUD. BUY_ASSET = spend AUD
            to buy this schedule's asset on each fire; SELL_ASSET = sell this
            schedule's asset for AUD on each fire.


            * `10` - buy asset

            * `20` - sell asset
          minimum: 0
          maximum: 32767
        period:
          type: string
        enabled:
          type: boolean
      required:
        - asset
        - direction
        - quantity
    RecurringTradeSchedule:
      type: object
      description: >-
        A recurring buy (DCA) schedule: automatically buys a set amount of an
        asset at a regular interval.
      properties:
        id:
          type: integer
          readOnly: true
        asset:
          type: string
        asset_name:
          type: string
          readOnly: true
        in_discovery_zone:
          type: boolean
          readOnly: true
        start:
          type: string
          format: date-time
        quantity:
          type: string
          format: decimal
          description: >-
            Amount to trade at each recurrence. When direction = BUY_ASSET, this
            is the AUD amount to spend buying the asset; when direction =
            SELL_ASSET, this is the quantity of the asset (in its native units)
            to sell.
        direction:
          allOf:
            - $ref: '#/components/schemas/TradeDirectionEnum'
          description: >-
            Direction of the recurring trade against AUD. BUY_ASSET = spend AUD
            to buy this schedule's asset on each fire; SELL_ASSET = sell this
            schedule's asset for AUD on each fire.


            * `10` - buy asset

            * `20` - sell asset
          minimum: 0
          maximum: 32767
        period:
          type: string
        enabled:
          type: boolean
      required:
        - asset
        - asset_name
        - direction
        - id
        - in_discovery_zone
        - quantity
    TradeDirectionEnum:
      enum:
        - 10
        - 20
      description: |-
        * `10` - buy asset
        * `20` - sell asset
        * `None` - alert only
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Personal API key, created in the Digital Surge app under Account
        Settings → API Keys. Send it with every request as `Authorization:
        Bearer <your-api-key>`.

````