> ## 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.

# Onramp Transaction

> This guide shows how to create your first onramp transaction on Conduit using the Transaction 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 “onramp” transaction — converting fiat currency to cryptocurrency. Let’s create an onramp converting 100 USD to USDT.

<Steps>
  <Step title="Create a quote">
    To create a quote, you need to use the `/quotes` endpoint. This will give you the current conversion rate for the given source and destination assets.

    ### 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": "100.00"
        },
        "target": {
          "asset": "USDT",
          "network": "tron"
        },
      }'
    ```

    ### Response Example

    ```json theme={null}
    {
      "id": "quote_2fvietuCNSu8unMNLsEGBrDTVFn",
      "source": {
        "amount": "100.00",
        "asset": "USD"
      },
      "target": {
        "amount": "99.50",
        "asset": "USDT",
        "network": "tron"
      },
      "createdAt": "2024-10-27T00:00:00.000Z",
      "expiresAt": "2024-10-27T00:03:00.000Z"
    }
    ```

    <Note>
      Success! Save this `quote_id` - you'll need it for transactions.
    </Note>
  </Step>

  <Step title="Create an onramp transaction">
    To create a onramp transaction, you need to use the `/transactions` endpoint. This will create a transaction where you are converting fiat currency to crypto currency.

    ### 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": "onramp",
        "quote": "quote_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
        "source": "bank_2UOcdiXWXbHdLRl3zfU2gG27yRi",
        "destination": "wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
        "purpose": "Other"
      }'
    ```

    ## Response Example

    ```json theme={null}
    {
      "type": "onramp",
      "id": "trxn_2ji0un2T6BaGhHKsmJu93Zf5OQm",
      "quote": "quote_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
      "source": {
        "id": "bank_2UOcdiXWXbHdLRl3zfU2gG27yRi",
        "asset": "USD",
        "amount": "100.00"
      },
      "destination": {
        "id": "wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
        "asset": "USDT",
        "network": "tron",
        "amount": "99.50"
      },
      "onrampInstructions": {
        "status": "ready",
        "data": [{
          "rail": "fedwire",
          "asset": "USD",
          "bank": {
            "bankName": "Conduit Bank",
            "accountNumber": "9876543210",
            "routingNumber": "021000021"
          }
        }]
      },
      "status": "created",
      "createdAt": "2024-10-26T02:21:03.742Z"
    }

    ```
  </Step>

  <Step title="Send your payment">
    Use the deposit instructions from the response to send your USD payment to the provided bank account. Once received, Conduit will automatically convert and send USDT to your crypto wallet!
  </Step>
</Steps>

## Summary

You have successfully created your first onramp transaction.

**What you can do now:**

* You can now create offramp transactions (crypto to fiat)
* You can now create transfer transactions (crypto to crypto)
* You can now create conversion transactions (crypto to crypto)

## What's next?

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

## API Reference

Check our [API Reference](/api-reference/transactions/create-a-transaction) to learn how to create onramp transactions using our API.

## Support

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