Create Transfer (Best Effort)

post

Creates a cross-chain transfer session.

Deposit any amount of the origin token to the returned depositAddress. The recipient will automatically receive the destination token, optimized for cost and speed.

Set dryMode: true to preview the transfer without creating an active session.

Body

application/json

originTokenstringRequired

The origin token in chain:address format

Example: base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

destinationTokenstringRequired

The destination token in chain:address format

Example: solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

recipientstringRequired

The recipient address in chain:address format

Example: solana:7aLBCrbn4jDNSxLLJYRRnKbkqA5cuaeaAzn74xS7eKPD

dryModebooleanOptional

If true, the deposit address will not be observed for deposits

Default: false

amountstringOptional

Expected input amount in smallest units. Optional, used for estimation only.

Example: 1000000

Responses

200

Transfer created successfully

application/json

post

/transfers/create-best-effort

HTTPcURLJavaScriptPython

POST /transfers/create-best-effort HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 273

{
  "originToken": "base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "destinationToken": "solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "recipient": "solana:7aLBCrbn4jDNSxLLJYRRnKbkqA5cuaeaAzn74xS7eKPD",
  "dryMode": false,
  "amount": "1000000",
  "appFee": {
    "usd": "1.25",
    "bps": 100
  }
}

200

Transfer created successfully

{
  "id": "txfr_1a2b3c4d5e6f",
  "status": "waiting_for_deposit",
  "originToken": "base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "originAmount": "1050000",
  "destinationToken": "solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "destinationAmount": "1000000",
  "recipient": "solana:7aLBCrbn4jDNSxLLJYRRnKbkqA5cuaeaAzn74xS7eKPD",
  "depositAddress": "base:0x4D9A6F3c7B2E1a8D5C0F9e7B6A4d2E8c1F3a5B7D",
  "depositToken": "base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "depositAmount": "1050000",
  "depositAcceptedAmount": "1050000",
  "deliveredAmount": "998000",
  "executionMode": "best_effort",
  "etaSeconds": 120,
  "fee": {
    "serviceFeeUSD": "0.50",
    "appFeeUSD": "1.25"
  }
}