Create Onramp Transfer

Create new Onramp Transfer

post

Creates onramp transfer and returns deposit information

Path parameters

customer_idstringrequired

The unique identifier of the customer

Header parameters

Authorizationstringrequired

Token for authentication

Body

amountstring · decimalrequired

The amount of the onramp transfer as a numeric string

Pattern: ^[0-9]+(\.[0-9]+)?$

source_currencystring · enumrequired

The currency to be deposited

Options: usd, eur

source_railsstring · enumrequired

The deposit rails to be used for the transaction

Options: swift, ach, sepa, wire

destination_networkstring · enumrequired

The blockchain network for the destination

Options: polygon, ethereum, tron, solana

destination_tokenstring · enumrequired

The token for the destination

Options: usdc, usdt

destination_addressstringrequired

The blockchain address where the funds will be sent

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.alignlabs.dev/v0/customers/{customer_id}/onramp-transfer' \
  --header 'Authorization: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": "text",
    "source_currency": "usd",
    "source_rails": "swift",
    "destination_network": "polygon",
    "destination_token": "usdc",
    "destination_address": "text"
  }'

application/json

201

201

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending",
  "amount": "text",
  "source_currency": "usd",
  "source_rails": "ach",
  "destination_network": "polygon",
  "destination_token": "usdc",
  "destination_address": "text",
  "quote": {
    "deposit_rails": "ach",
    "deposit_currency": "usd",
    "deposit_bank_account": {
      "bank_name": "text",
      "bank_address": "text",
      "account_beneficiary_type": "individual",
      "account_beneficiary_name": "text",
      "account_type": "us",
      "iban": {
        "bic": "text",
        "iban_number": "text"
      }
    },
    "deposit_amount": "text",
    "deposit_message": "text",
    "fee_amount": "text"
  }
}

Successful onramp transfer initiation response