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 “offramp” transaction — converting cryptocurrency to fiat currency. Let’s create an offramp converting 100 USDT to USD.
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": "USDT",
      "network": "tron",
      "amount": "100.00"
    },
    "target": {
      "asset": "USD"
    }
  }'

​
Response Example

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

Create a transaction

To create a transaction, you need to use the /transactions endpoint. This will create a transaction for the given quote.

​
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": "offramp",
    "quote": "quote_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
    "source": "wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
    "destination": "bank_1234",
    "documents": ["doc_2nqjHpNLK6wSNlFyMvZgX8SYeAO"],
    "purpose": "Other",
    "reference": "TRX#09123A"
  }'

​
Response Example

{
  "type": "offramp",
  "id": "trxn_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
  "quote": "quote_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
  "source": {
    "id": "wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
    "asset": "USDT",
    "network": "tron",
    "amount": "100.00"
  },
  "destination": {
    "id": "bank_1234",
    "asset": "USD",
    "amount": "99.50"
  },
  "status": "created",
  "createdAt": "2024-10-27T00:00:00.000Z",
  "documents": [
    {
      "id": "doc_2nqjHpNLK6wSNlFyMvZgX8SYeAO"
    }
  ],
  "purpose": "Other",
  "reference": "TRX#09123A"
}
The source is the id of either a crypto wallet or a bank account in your customer’s account. This is the wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO or bank_1234 in the response example. This is required to identify the true sender of the funds.
The destination is the id of a bank account payment method of the customer or counterparty that will receive the funds.

​
Summary

You have successfully created your first offramp transaction on Conduit using the Transaction API on Conduit.

​
What’s next?

​
API Reference

See the API Reference to learn how to create offramp transactions using our API.

​
Support

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