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.

🎉 You’re done!

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