post
https://api.1money.com/v1/customers//auto-conversion-rules
Create an Auto-Conversion Rule for fiat->crypto, crypto->fiat, or crypto->crypto conversions.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Supported Assets:
USD,USDC,USDT,PYUSD,RLUSD,USDG,USDP,EURC,MXNB
Supported Networks:- Fiat deposit networks:
US_FEDWIRE,SWIFT - Crypto networks:
ETHEREUM,POLYGON,BASE,ARBITRUM,AVALANCHE,BNBCHAIN,SOLANA,TRON
Validation Rules:
- Supported pairs: fiat->crypto, crypto->fiat, and crypto->crypto; fiat->fiat is NOT supported
Idempotency-Keyheader is required and must be a valid UUID v4- Source network must match asset type (fiat asset requires fiat network, crypto asset requires crypto network)
- For crypto withdrawal destination:
networkis required whenwallet_addressis provided - For fiat destination:
networkwill be omitted - For a crypto-to-fiat bank payout that requires a local payment code, set
destination.codeto the applicable value from the Local Payment Code guide
Withdrawal Configuration:
- Fiat-to-Crypto or Crypto->Crypto with withdrawal: provide
wallet_address(external crypto wallet address) - Crypto-to-Fiat with withdrawal: provide
external_account_id(bank account ID from external-accounts API) - Conversion-only (no withdrawal): omit both fields, converted funds remain in customer's account
Idempotency & Webhook Behavior:
- This endpoint provisions resources asynchronously. A rule-creation webhook may arrive before the HTTP response.
- Reusing an existing
Idempotency-Keyreturns409 Conflict. Use Get Auto-Conversion Rule by Idempotency Key to retrieve the rule after a duplicate request, timeout, or webhook. - Correlate the response and webhook with the creation key, then retrieve the rule to check its current status and deposit information.
Response & Status:
- The create response returns the rule's current
status. It may still bePENDING, or asynchronous provisioning may already have advanced it. - The create response omits
deposit_info_statusandsource_deposit_info, even if the returned rule is alreadyACTIVE. - Retrieve the rule to get deposit information. Only fund it when
deposit_info_status=ACTIVEandsource_deposit_infois present. Rulestatus=ACTIVEalone does not establish that deposit information is available.
