IMMIX Enquiry API

openapi: 3.2.0
info:
  title: IMMIX Enquiry API
  version: 1.1.0
  summary: Submit one enquiry to the IMMIX desk.
  description: The only public endpoint on immix.xyz. It accepts the same enquiry the form on /build-a-market sends, re-validates it server-side and delivers it to the desk, who reply by email. It does not quote prices, open accounts, or execute anything. Errors are structured JSON. Requests are limited to 5 per minute per address; a refused request answers 429 with Retry-After.
  contact:
    name: IMMIX
    url: https://immix.xyz/build-a-market
    email: sales@immix.xyz
  termsOfService: https://immix.xyz/legal/terms
servers:
- url: https://immix.xyz
tags:
- name: Enquiry
paths:
  /api/leads:
    post:
      operationId: submitLead
      summary: Submit an enquiry
      description: 'Send one enquiry. Use kind "contact" for the Build with IMMIX form. The payload carries the fields listed below; a field name the server does not know is refused with 400. Success (202) means the enquiry has been delivered to the desk; nothing else is promised. Replaying it is safe: the server derives a key from the content and, for 24 hours after a delivery, answers the same content with 202 without delivering it again. The check is not atomic: two identical requests in flight together may both be delivered, each marked with the same key.'
      tags:
      - Enquiry
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LeadSubmission'
            example:
              kind: contact
              payload:
                email: ops@example.com
                company: Example Payments Ltd
                topic: Price a payment corridor
                message: We move EUR to a non-USD stablecoin daily and want to compare one corridor.
                consent: true
              idempotencyKey: 8023ebf00a655bf9e5f6a077531e057ef589becb8f8c5eb5bcdf7b57f6350a8b
              sentAt: '2026-08-26T12:00:00.000Z'
      parameters:
      - name: X-Idempotency-Key
        in: header
        required: false
        schema:
          type: string
        description: Optional. The site's own form sends it; the server accepts and ignores it, and de-duplicates on a key it derives from the content.
      responses:
        '202':
          description: Delivered to the desk — by this request, or by one with the same content in the previous 24 hours.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Accepted'
        '400':
          description: Invalid body or fields. Fix the listed fields and resend.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '405':
          description: Method not allowed — only POST (and OPTIONS preflight).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: Body larger than 32 KB. Shorten the message and resend.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many requests from this address. Wait for Retry-After seconds.
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: The service could not deliver the enquiry. Nothing was recorded; retry later.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      required:
      - ok
      - reason
      - message
      properties:
        ok:
          type: boolean
          const: false
        reason:
          type: string
          enum:
          - invalid
          - server
          - network
          - not-configured
        message:
          type: string
          description: Human- and agent-readable sentence with a resolution hint.
        errors:
          type: object
          additionalProperties:
            type: string
          description: Field name to error message (400 only).
    Accepted:
      type: object
      required:
      - ok
      properties:
        ok:
          type: boolean
          const: true
    ContactPayload:
      type: object
      required:
      - email
      - message
      - consent
      properties:
        email:
          type: string
          format: email
          maxLength: 254
          description: Work email. Free-mail domains are rejected by the form; the API accepts any syntactically valid address.
        company:
          type: string
          maxLength: 200
        pairs:
          type: string
          maxLength: 160
          description: The currencies or stablecoins of interest, free text.
        topic:
          type: string
          maxLength: 80
          enum:
          - Trade non-USD stablecoin FX
          - Market making for our stablecoin
          - Liquidity for our venue or platform
          - Price a payment corridor
          - Other enquiry
          description: One of the form's topics, exactly as listed; any other value is refused with 400.
        message:
          type: string
          maxLength: 4000
        consent:
          type: boolean
          const: true
          description: 'Must be true: consent to IMMIX processing the enquiry in order to respond to it (see /legal/privacy).'
    LeadSubmission:
      type: object
      required:
      - kind
      - payload
      properties:
        kind:
          type: string
          enum:
          - brief
          - pilot
          - contact
          description: Which capture surface produced the enquiry. The site form sends "contact".
        payload:
          $ref: '#/components/schemas/ContactPayload'
        idempotencyKey:
          type: string
          description: 'Optional. Accepted for compatibility and ignored: the server derives its own key from the content.'
        sentAt:
          type: string
          format: date-time