Skip to main content

​
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
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.
1

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

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

{
  "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"
}
Success! Save this quote_id - you’ll need it for transactions.
2

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

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

{
  "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"
}
3

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!

​
🎉 You’re Done!

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

​
API Reference

Check our API Reference to learn how to create onramp transactions using our API.

​
Support

Reach out to our support team to get help and share your feedback.
⌘I