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 fiat conversion — exchanging one fiat currency for another (e.g., USD → EUR) and paying a destination bank account.
1

Create a quote

Use the /quotes endpoint to get a locked rate for your source and target currencies.

​
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": "1000.00"
    },
    "target": {
      "asset": "EUR"
    }
  }'

​
Response Example

{
  "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"
}
Save the quote_id; you will need it when creating the transaction.
2

Create a fiat conversion transaction

Use the /transactions endpoint with type: conversion and the 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": "conversion",
    "quote": "quote_34LGFxjgPBqCwLXBX1AD1D8SXvv",
    "source": "bank_2UOcdiXWXbHdLRl3zfU2gG27yRi",
    "destination": "bank_2kezVryAA3Uw9LJYBiXUV7Pj6gu",
    "purpose": "Other",
    "reference": "INV-2024-001"
  }'

​
Response Example

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

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.

​
Summary

You have successfully created your first fiat conversion transaction.

​
What’s next?

​
API Reference

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

​
Support

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