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

# Many→one SOL consolidate

> Sweeps `percentage` of each source wallet's balance into a single
receiver. Replaces `POST /api/sol/consolidate` from `public.raze.sh`.
Returns partially-signed transactions.




## OpenAPI

````yaml openapi-spec/history.yaml post /utils/sol/consolidate
openapi: 3.0.3
info:
  title: Raze Database API
  description: >
    Paid subscription API for Solana transaction data and history.


    Also hosts write utilities (`/utils/sol/*`): token launch, transfer, burn,

    distribute, consolidate, and fee claim/config — previously on

    `router.raze.bot`.


    ## Batch Requests

    All endpoints with path parameters (mint, signer, address, tokenMint,
    ownerAddress) support batch queries

    via comma-separated values. For example:
    `/api/sol/trades/mint/mint1,mint2,mint3?limit=50`


    - Maximum 10 values per batch request

    - Each value must be a valid address (>= 32 characters)

    - Single values behave identically to non-batch requests

    - Batch response format: `{ "success": true, "results": { "value1": {...},
    "value2": {...} }, "count": N, "timestamp": "..." }`

    - Each key in `results` contains the full single-entity response

    - Queries run in parallel for maximum performance
  version: 1.0.0
servers:
  - url: https://api.raze.bot
    description: >-
      Raze global History API — GeoDNS routes to the nearest region
      automatically
security:
  - ApiKeyAuth: []
paths:
  /utils/sol/consolidate:
    post:
      summary: Many→one SOL consolidate
      description: |
        Sweeps `percentage` of each source wallet's balance into a single
        receiver. Replaces `POST /api/sol/consolidate` from `public.raze.sh`.
        Returns partially-signed transactions.
      operationId: utilsSolConsolidate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConsolidateRequest'
      responses:
        '200':
          description: Response envelope with partially-signed transactions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UtilsResponse'
      security:
        - ApiKeyAuth: []
        - BearerAuth: []
components:
  schemas:
    ConsolidateRequest:
      type: object
      description: >-
        Many→one SOL sweep with percentage. Sweeps `percentage` of each source
        wallet's balance into a single receiver. Returns partially-signed
        transactions.
      properties:
        wallets:
          type: array
          items:
            type: string
        receiver:
          type: string
        percentage:
          type: number
          description: 1–100.
        feeTipLamports:
          type: integer
        tipWallet:
          type: string
          description: Custom tip recipient wallet (defaults to the Raze relay tip wallet).
        tipLamports:
          type: integer
          description: >-
            Flat tip in lamports, floored at 100000. Takes precedence over
            feeTipLamports.
        feeWallet:
          type: string
          description: Custom fee recipient wallet. Only charged together with feeBps.
        feeBps:
          type: integer
          description: |
            Percentage fee in basis points of the SOL volume this endpoint
            moves, sent to feeWallet. Endpoints with no SOL volume charge
            nothing.
        encoding:
          type: string
          enum:
            - base64
            - base58
        simulate:
          type: boolean
      required:
        - wallets
        - receiver
        - percentage
    UtilsResponse:
      type: object
      description: |
        Shared envelope for every `/utils/sol/*` write endpoint. Optional
        fields are omitted from the JSON when unset.
      properties:
        success:
          type: boolean
        transactions:
          type: array
          description: Serialized partially-signed transactions in submission order.
          items:
            type: string
        batches:
          type: array
          description: |
            For batch endpoints (`transfer`, `burn`): packing metadata.
            `batches[i]` describes `transactions[i]`.
          items:
            $ref: '#/components/schemas/BatchInfo'
        mint:
          type: string
          description: Set by `/utils/sol/launch` — the mint of the launched token.
        platform:
          type: string
          description: Set by `/utils/sol/launch` and `/utils/sol/fees/claim`.
        status:
          type: object
          description: Set by `/utils/sol/fees/config` for `action=status` reads.
        simulations:
          type: array
          description: |
            Set when the request had `simulate: true`. One entry per built tx,
            in the same order as `transactions`. Each entry is the RPC
            `simulateTransaction` `value` object (logs / unitsConsumed / err).
          items:
            type: object
        error:
          type: string
      required:
        - success
    BatchInfo:
      type: object
      description: |
        Per-transaction packing metadata returned by batch endpoints. Lets the
        caller correlate input items → serialized txs for partial-retry logic
        when one tx in a batch lands and another doesn't.
      properties:
        signers:
          type: array
          items:
            type: string
          description: Required signers for this tx (fee payer first).
        itemIndices:
          type: array
          items:
            type: integer
          description: Indices into the request's `items[]` array packed into this tx.
        instructionCount:
          type: integer
          description: >-
            Non-fee instructions in this tx (excludes compute-budget + fee
            transfers).
      required:
        - signers
        - itemIndices
        - instructionCount
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: apiKey

````