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

# Create liquidation address

> Legacy address model; new integrations use standing deposit addresses. Create liquidation address.

**/v1/liquidation-addresses**


## OpenAPI

````yaml https://orchestration.flashnet.xyz/openapi.json POST /v1/liquidation-addresses
openapi: 3.1.0
info:
  title: Flashnet Orchestrator API
  version: 0.1.0
  description: >-
    Partner API for quotes, orders, standing deposits, webhooks, and affiliates.
    Operations marked x-excluded are omitted from the documentation navigation;
    internal, pay-link, SSE, and provider-integration routes are outside this
    registry.
servers:
  - url: https://orchestration.flashnet.xyz
security: []
tags:
  - name: Orchestration
    description: >-
      Routes, limits, estimates, quotes, orders, onramp, and ZeroConf decisions
      for one-off swaps.
  - name: Standing Deposit Addresses
    description: >-
      Permanent per-customer deposit addresses bound to one immutable conversion
      instruction.
  - name: Webhooks
    description: >-
      Registration of HTTPS endpoints for order status events and recovery
      events.
  - name: Affiliates
    description: Registered fee recipients, their accrued balances, and claims.
  - name: Accumulation Addresses
    description: >-
      Legacy reusable addresses that convert one source asset into Spark BTC or
      USDB.
  - name: Liquidations
    description: >-
      Legacy Bitcoin L1 deposit addresses that convert each output to a
      configured destination.
  - name: System
  - name: Explorer
  - name: Dashboard
  - name: Affiliate Dashboard
paths:
  /v1/liquidation-addresses:
    post:
      tags:
        - Liquidations
      summary: Create liquidation address
      description: >-
        Legacy address model; new integrations use standing deposit addresses.
        Create liquidation address.
      operationId: postV1LiquidationAddresses
      parameters:
        - schema:
            type: string
            minLength: 1
          required: true
          name: X-Idempotency-Key
          in: header
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LiquidationAddressCreateRequest'
      responses:
        '200':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiquidationAddressRecord'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      deprecated: true
      security:
        - bearerAuth: []
components:
  schemas:
    LiquidationAddressCreateRequest:
      type: object
      properties:
        label:
          type: string
          maxLength: 255
          pattern: ^[^\x00-\x1F\x7F]*$
        destinationChain:
          $ref: '#/components/schemas/Chain'
        destinationAsset:
          type: string
          minLength: 1
        destinationAddress:
          type: string
          minLength: 1
          description: >-
            Server canonicalizes by trimming leading/trailing whitespace; case
            is preserved.
        slippageBps:
          type: integer
          minimum: 0
          maximum: 10000
        feeBps:
          type: integer
          minimum: 0
          maximum: 9999
        appFees:
          type: array
          items:
            $ref: '#/components/schemas/OrchestrationAppFeeRequest'
          minItems: 1
          maxItems: 16
        affiliateIds:
          type: array
          items:
            $ref: '#/components/schemas/OrchestrationAffiliateIdEntry'
          minItems: 1
          maxItems: 16
          description: >-
            Registered affiliate IDs or fee overrides for each deposit; mutually
            exclusive with appFees, with overrides requiring a server key or
            dashboard session.
      required:
        - destinationChain
        - destinationAddress
      description: Unknown top-level fields are ignored rather than rejected.
    LiquidationAddressRecord:
      type: object
      properties:
        liquidationAddressId:
          type: string
        label:
          type: string
        sparkAddress:
          type: string
        l1DepositAddress:
          type: string
        destination:
          $ref: '#/components/schemas/LiquidationDestination'
        feeBps:
          type: integer
        slippageBps:
          type: integer
        enabled:
          type: boolean
        createdAt:
          type: string
        updatedAt:
          type: string
        disabledAt:
          type:
            - string
            - 'null'
        appFees:
          type: array
          items:
            $ref: '#/components/schemas/AddressAppFee'
      required:
        - liquidationAddressId
        - label
        - sparkAddress
        - l1DepositAddress
        - destination
        - feeBps
        - slippageBps
        - enabled
        - createdAt
      additionalProperties: false
    ErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      required:
        - error
      additionalProperties: false
    Chain:
      type: string
      enum:
        - arbitrum
        - arc
        - avalanche
        - base
        - bitcoin
        - bsc
        - ethereum
        - hedera
        - hypercore
        - hyperevm
        - lightning
        - litecoin
        - monad
        - monero
        - optimism
        - plasma
        - polygon
        - robinhood
        - sei
        - solana
        - spark
        - tempo
        - ton
        - tron
        - xrp
        - zcash
    OrchestrationAppFeeRequest:
      type: object
      properties:
        recipient:
          type: string
          minLength: 1
          description: Fee recipient address; sanctioned addresses are rejected.
        fee:
          type: integer
          minimum: 1
          maximum: 9999
      required:
        - recipient
        - fee
      description: Unknown top-level fields are ignored rather than rejected.
    OrchestrationAffiliateIdEntry:
      anyOf:
        - type: string
          minLength: 1
          description: Registered affiliate id. Uses the profile's static feeBps.
        - type: object
          properties:
            affiliateId:
              type: string
              minLength: 1
            feeBps:
              type: integer
              minimum: 1
              maximum: 9999
              description: >-
                Fee override for this quote only; the stored affiliate profile
                is unchanged.
          required:
            - affiliateId
            - feeBps
          additionalProperties: false
      description: Registered affiliate ID or { affiliateId, feeBps } override.
    LiquidationDestination:
      type: object
      properties:
        chain:
          $ref: '#/components/schemas/Chain'
        asset:
          type: string
        address:
          type: string
      required:
        - chain
        - asset
        - address
      additionalProperties: false
    AddressAppFee:
      type: object
      properties:
        affiliateId:
          type: string
        recipient:
          type: string
          minLength: 1
          description: Fee recipient address; sanctioned addresses are rejected.
        feeBps:
          type: integer
          minimum: 1
          maximum: 9999
      required:
        - recipient
        - feeBps
      additionalProperties: false
    ErrorDetail:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Partner API key in the form `Authorization: Bearer fn_...`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.