Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
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