Create Quote

Create Onramp Transfer Quote

post

/v0/customers/{customer_id}/onramp-transfer/quote

Authorizations

Api-KeystringRequired

Path parameters

customer_idstring · uuidRequired

The unique identifier of the customer

Body

Either source_amount OR destination_amount must be provided to calculate the quote in the desired direction

or

Responses

201

Quote created successfully

application/json

quote_idstring · uuidRequired

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

source_currencystring · enumRequiredPossible values:

source_payment_railsstring · enumRequiredPossible values:

destination_tokenstring · enumRequiredPossible values:

destination_networkstring · enumRequiredPossible values:

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

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

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

expire_atstring · date-timeRequired

UTC timestamp after which the quote can no longer be used to create a transfer

Example: 2026-06-24T12:05:00.000Z

post/v0/customers/{customer_id}/onramp-transfer/quote

POST /v0/customers/{customer_id}/onramp-transfer/quote HTTP/1.1
Host: api.alignlabs.dev
Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 168

{
  "source_amount": "100.50",
  "source_payment_rails": "ach",
  "source_currency": "usd",
  "destination_token": "usdc",
  "destination_network": "polygon",
  "developer_fee_percent": "0.5"
}

201

Quote created successfully

{
  "quote_id": "123e4567-e89b-12d3-a456-426614174000",
  "source_amount": "100.50",
  "source_currency": "usd",
  "source_payment_rails": "ach",
  "destination_token": "usdc",
  "destination_network": "polygon",
  "destination_amount": "100.50",
  "fee_amount": "10.50",
  "exchange_rate": "text",
  "expire_at": "2026-06-24T12:05:00.000Z"
}