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

# Fiat Conversion Transaction

> This guide shows how to create your first fiat conversion (cross-currency) using the Transactions API.

## Pre-requisites

* You have an active Conduit account with API access
* You have API credentials (API Key and Secret)
* You have reviewed our [Customers](/core-concepts/customers) Core Concepts

In this guide, you’ll create your first fiat conversion — exchanging one fiat currency for another (e.g., USD → EUR) and paying a destination bank account.

<Steps>
  <Step title="Create a quote">
    Use the `/quotes` endpoint to get a locked rate for your source and target currencies.

    ### Request Example

    ```bash theme={null}
    curl --request POST \
      --url https://api.conduit.financial/quotes \
      --header "X-API-Key: your_api_key" \
      --header "X-API-Secret: your_api_secret" \
      --header "Content-Type: application/json" \
      --header "Api-Version: 2024-12-01" \
      --data '{
        "source": {
          "asset": "USD",
          "amount": "1000.00"
        },
        "target": {
          "asset": "EUR"
        }
      }'
    ```

    ### Response Example

    ```json theme={null}
    {
      "id": "quote_34LGFxjgPBqCwLXBX1AD1D8SXvv",
      "source": {
        "amount": "1000.00",
        "asset": "USD"
      },
      "target": {
        "amount": "915.00",
        "asset": "EUR"
      },
      "createdAt": "2025-10-27T00:00:00.000Z",
      "expiresAt": "2025-10-27T00:03:00.000Z"
    }
    ```

    <Note>
      Save the `quote_id`; you will need it when creating the transaction.
    </Note>
  </Step>

  <Step title="Create a fiat conversion transaction">
    Use the `/transactions` endpoint with `type: conversion` and the quote.

    ### Request Example

    ```bash theme={null}
    curl --request POST \
      --url https://api.conduit.financial/transactions \
      --header "X-API-Key: your_api_key" \
      --header "X-API-Secret: your_api_secret" \
      --header "Content-Type: application/json" \
      --header "Api-Version: 2024-12-01" \
      --data '{
        "type": "conversion",
        "quote": "quote_34LGFxjgPBqCwLXBX1AD1D8SXvv",
        "source": "bank_2UOcdiXWXbHdLRl3zfU2gG27yRi",
        "destination": "bank_2kezVryAA3Uw9LJYBiXUV7Pj6gu",
        "purpose": "Other",
        "reference": "INV-2024-001"
      }'
    ```

    ### Response Example

    ```json theme={null}
    {
      "type": "conversion",
      "id": "trxn_34LGGAWJgBGs4vI9rYHzR7Lx42G",
      "quote": "quote_34LGFxjgPBqCwLXBX1AD1D8SXvv",
      "status": "created",
      "source": {
        "id": "bank_34LGFSCBNomvij564oMkdf9xtbz",
        "asset": "USD",
        "amount": "1000.00"
      },
      "destination": {
        "id": "bank_34LGFXmlQwaJb4GO3mzapUm78GI",
        "asset": "EUR",
        "amount": "915.00"
      },
      "depositInstructions": {
        "status": "ready",
        "data": [{
          "rail": "fedwire",
          "asset": "USD",
          "bank": {
            "bankName": "Lead Bank",
            "accountNumber": "1000682791",
            "routingNumber": "101206101"
          },
          "accountOwner": { "name": "Conduit Technology, Inc." },
          "reference": ""
        }]
      },
      "documents": [{"id": "doc_34LGD9hyXfhBKfFhrx2MX4fscza"}],
      "purpose": "PaymentsForGoodsOrServices",
      "reference": "INV-2024-001",
      "createdAt": "2025-10-27T00:00:00.000Z"
    }
    ```
  </Step>

  <Step title="Send funds using deposit instructions">
    Use the deposit instructions to send your source currency. Conduit converts and pays the destination account in the target currency.
  </Step>
</Steps>

## Summary

You have successfully created your first fiat conversion transaction.

## What's next?

* Set up webhooks to receive transaction status updates: [Configuring Your First Webhook](/guides/webhooks/first-webhook)
* Review [Conversions](/core-concepts/transactions/conversions) Core Concept

## API Reference

See the [API Reference](/api-reference/transactions/create-a-transaction) to learn how to create fiat conversion transactions using our API.

## Support

Reach out to our [support team](https://support.conduitpay.com/) to get help and share your feedback.