Create Quote

Create Cross-Chain Transfer Quote

post

/v0/customers/{customer_id}/cross-chain-transfer/quote

Path parameters

customer_idstring · uuidRequired

The unique identifier of the customer

Header parameters

Api-KeystringRequired

Your secret API key, available in the developer dashboard. Include this header on every request to authenticate your application.

Idempotency-KeystringRequired

Unique key to prevent duplicate requests

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_tokenstring · enumRequiredExample: usdcPossible values:

source_networkstring · enumRequiredExample: ethereumPossible values:

destination_tokenstring · enumRequiredExample: eurcPossible values:

destination_networkstring · enumRequiredExample: polygonPossible values:

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

fee_amountstringOptional

The total fee amount for the cross-chain transfer, denominated in the source token

Example: 2.00Pattern: ^[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}/cross-chain-transfer/quote

POST /v0/customers/{customer_id}/cross-chain-transfer/quote HTTP/1.1
Host: api.alignlabs.dev
Api-Key: text
Idempotency-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 162

{
  "source_amount": "text",
  "source_token": "usdc",
  "source_network": "polygon",
  "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_token": "usdc",
  "source_network": "ethereum",
  "destination_token": "eurc",
  "destination_network": "polygon",
  "destination_amount": "98.50",
  "fee_amount": "2.00",
  "exchange_rate": "text",
  "expire_at": "2026-06-24T12:05:00.000Z"
}