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

# Create Conversion

> Directly create a crypto-to-crypto swap or a fiat payout conversion — no OTP required

<Note>
  **Auth method: Signed (HMAC)** — this endpoint requires the full set of signed
  headers: `x-access-id`, `x-request-id`, `x-timestamp`, and an HMAC-SHA256
  `authorization` signature. See [Authentication](/api-reference/authentication#signed-hmac-authentication).
</Note>

## Headers

<ParamField header="authorization" type="string" required>
  Base64-encoded HMAC-SHA256 signature of the request payload

  **Example:** `"5e73d044c44d733fcf819ad3409aaad..."`
</ParamField>

<ParamField header="x-timestamp" type="string" required>
  Current timestamp in ISO 8601 format

  **Example:** `"2025-03-15T09:45:53.000Z"`
</ParamField>

<ParamField header="x-request-id" type="string" required>
  Unique UUID v4 for the request

  **Example:** `"550e8400-e29b-41d4-a716-446655440000"`
</ParamField>

<ParamField header="x-access-id" type="string" required>
  Your API access ID provided by Tender

  **Example:** `"your-access-id-here"`
</ParamField>

<ParamField header="Content-Type" type="string" required>
  **Example:** `"application/json"`
</ParamField>

## Body

<ParamField body="type" type="string" required>
  Conversion type. Use `crypto` to swap to another coin/chain, or `fiat` to convert to a payout account.

  **Allowed values:** `crypto`, `fiat`

  **Example:** `"crypto"`
</ParamField>

<ParamField body="chain" type="string" required>
  Source blockchain chain ID

  **Example:** `"ethereum"`
</ParamField>

<ParamField body="coin" type="string" required>
  Source coin ID

  **Example:** `"usdt"`
</ParamField>

<ParamField body="amount" type="string" required>
  Amount to convert

  **Example:** `"100"`
</ParamField>

<ParamField body="toChain" type="string">
  Destination chain. **Required when `type` is `crypto`.**

  **Example:** `"solana"`
</ParamField>

<ParamField body="toCoin" type="string">
  Destination coin. **Required when `type` is `crypto`.**

  **Example:** `"sol"`
</ParamField>

<ParamField body="payoutAccountId" type="string">
  Payout account to receive funds. **Required when `type` is `fiat`.**

  **Example:** `"66aec7de809b7f45c42a49f9"`
</ParamField>

## Response

<ResponseField name="status" type="string" required>
  **Example:** `"success"`
</ResponseField>

<ResponseField name="message" type="string" required>
  **Example:** `"Conversion created successfully"`
</ResponseField>

<ResponseField name="data" type="object" required>
  <Expandable title="data properties">
    <ResponseField name="conversion" type="object">
      The newly created conversion record

      <Expandable title="conversion properties">
        <ResponseField name="_id" type="string">
          **Example:** `"66aec7de809b7f45c42a49f9"`
        </ResponseField>

        <ResponseField name="type" type="string">
          **Example:** `"crypto"`
        </ResponseField>

        <ResponseField name="status" type="string">
          Initial status after creation

          **Example:** `"pending"`
        </ResponseField>

        <ResponseField name="amount" type="string">
          **Example:** `"100"`
        </ResponseField>

        <ResponseField name="coin" type="string">
          **Example:** `"usdt"`
        </ResponseField>

        <ResponseField name="chain" type="string">
          **Example:** `"ethereum"`
        </ResponseField>

        <ResponseField name="toChain" type="string">
          Present for crypto swaps

          **Example:** `"solana"`
        </ResponseField>

        <ResponseField name="toCoin" type="string">
          Present for crypto swaps

          **Example:** `"sol"`
        </ResponseField>

        <ResponseField name="processingStages" type="object">
          All stages initialised to `pending`

          **Example:** `{ "sendForConversion": { "status": "pending" }, "conversionState": { "status": "pending" }, "settleCrypto": { "status": "pending" } }`
        </ResponseField>

        <ResponseField name="createdAt" type="string">
          **Example:** `"2024-09-24T22:20:15.650Z"`
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>