> ## Documentation Index > Fetch the complete documentation index at: https://docs.agg.market/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > To integrate AGG, start with Quickstart: REST (https://docs.agg.market/quickstart/rest), then Order lifecycle & statuses (https://docs.agg.market/concepts/order-lifecycle). > Track every trade until it reaches a terminal status. Before retrying a failed or timed-out call, read Errors, retries & idempotency (https://docs.agg.market/concepts/errors). > The API reference is generated from https://docs.agg.market/openapi/openapi.json. # Update or pause a managed balance refill policy ## OpenAPI ````yaml /openapi/openapi.json patch /execution/balance-refill-policies/{policyId} openapi: 3.0.2 info: title: AGG API version: 1.0.0 description: >- Prediction market aggregator REST API — authentication, users, venue events, venue markets, orderbooks, charts, and execution workflows. servers: - url: https://api.agg.market description: Production security: [] tags: - name: Authentication description: Sign users in and manage their session tokens. - name: Markets description: Find events, markets and outcomes to trade. - name: Market Data description: Live orderbooks, prices, charts and scores for those markets. - name: Trading description: Quote, place, sign, track and cancel orders. - name: Portfolio description: A user's orders, positions, balances and activity. - name: Funding description: Deposit addresses, withdrawals, balance refills and fiat on-ramp. - name: Users description: The signed-in user's profile, linked accounts, KYC and venue keys. - name: Hosted Venue Accounts description: Provision, fund and withdraw from venue accounts hosted for the user. - name: Webhooks description: Configure and operate webhook delivery to your server. - name: Partner Admin description: Server-side reads across your app's users, orders and analytics. - name: Paper Trading description: Simulated accounts and orders for testing without real funds. - name: News description: News feeds linked to markets. - name: Correlated Markets description: Markets related to a given market and the effect of its resolution. paths: /execution/balance-refill-policies/{policyId}: patch: tags: - Funding summary: Update or pause a managed balance refill policy operationId: updateBalanceRefillPolicy parameters: - name: policyId in: path required: true schema: type: string requestBody: required: true content: application/json: schema: type: object properties: minimumRaw: pattern: ^[1-9][0-9]*$ description: >- Refill when the target-chain balance falls below this. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string refillAmountRaw: pattern: ^[1-9][0-9]*$ description: >- Amount to deliver per refill. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string dailyCapRaw: pattern: ^[1-9][0-9]*$ description: >- Most that can be refilled per day. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string maxFeeRaw: pattern: ^[1-9][0-9]*$ description: >- Most one refill may pay in transfer fees. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string status: description: >- `enabled`: refills run. `paused`: no refills until re-enabled. type: string enum: - enabled - paused responses: '200': description: '200' content: application/json: schema: $ref: '#/components/schemas/BalanceRefillPolicy' '400': description: '400' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' '401': description: '401' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' '403': description: '403' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' '404': description: '404' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' security: - appId: [] bearerAuth: [] components: schemas: BalanceRefillPolicy: type: object required: - id - targetChainId - targetTokenAddress - targetTokenSymbol - minimumRaw - refillAmountRaw - dailyCapRaw - maxFeeRaw - status - cooldownSeconds - lastObservedRaw - lastEvaluatedAt - nextEligibleAt - consentedAt - createdAt - updatedAt - latestAttempt properties: id: description: Policy id. type: string targetChainId: description: Chain kept topped up. type: integer targetTokenAddress: description: USDC contract on that chain. type: string targetTokenSymbol: description: Always `USDC`. type: string enum: - USDC minimumRaw: pattern: ^[1-9][0-9]*$ description: >- Refill when the target-chain balance falls below this. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string refillAmountRaw: pattern: ^[1-9][0-9]*$ description: >- Amount to deliver per refill. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string dailyCapRaw: pattern: ^[1-9][0-9]*$ description: >- Most that can be refilled per day. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string maxFeeRaw: pattern: ^[1-9][0-9]*$ description: >- Most one refill may pay in transfer fees. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string status: description: '`enabled`: refills run. `paused`: no refills until re-enabled.' type: string enum: - enabled - paused cooldownSeconds: minimum: 60 description: Minimum seconds between refills. type: integer lastObservedRaw: description: >- Target-chain balance at the last check. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). pattern: ^[0-9]+$ type: string nullable: true lastEvaluatedAt: description: When the balance was last checked. format: date-time type: string nullable: true nextEligibleAt: description: Earliest time the next refill may run. format: date-time type: string nullable: true consentedAt: format: date-time description: When the user consented. type: string createdAt: format: date-time description: Creation time. type: string updatedAt: format: date-time description: Time of the last change. type: string latestAttempt: description: Most recent refill attempt, if any. type: object required: - id - policyId - status - triggerBalanceRaw - requestedDeliveryRaw - sourceAmountRaw - completedAmountRaw - sourceChainId - targetChainId - feeRaw - errorMessage - startedAt - completedAt - createdAt properties: id: description: Refill attempt id. type: string policyId: description: Policy that triggered it. type: string status: description: >- `reserved`: funds set aside, not yet moving. `executing`: moving. `completed` or `failed`: final. type: string enum: - reserved - executing - completed - failed triggerBalanceRaw: pattern: ^[0-9]+$ description: >- Target-chain balance that triggered the refill. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string requestedDeliveryRaw: pattern: ^[1-9][0-9]*$ description: >- Amount the refill aims to deliver. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string sourceAmountRaw: pattern: ^[1-9][0-9]*$ description: >- Amount taken from the source chain. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). type: string completedAmountRaw: description: >- Amount delivered; `null` until complete. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). pattern: ^[0-9]+$ type: string nullable: true sourceChainId: description: Chain the funds came from. type: integer targetChainId: description: Chain refilled. type: integer feeRaw: description: >- Transfer fee, deducted from the amount moved. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00). pattern: ^[0-9]+$ type: string nullable: true errorMessage: description: Readable failure reason. type: string nullable: true startedAt: description: When the transfer started. format: date-time type: string nullable: true completedAt: description: When it finished. format: date-time type: string nullable: true createdAt: format: date-time description: When the attempt was created. type: string nullable: true ErrorMessage: type: object required: - message properties: message: type: string securitySchemes: appId: type: apiKey in: header name: x-app-id description: Your application ID. Required for all app-tier and user-tier routes. bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT access token returned by POST /auth/verify. Required for user-tier routes. ````