FX Swaps

{
  "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
  "source_asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "source_asset_amount": "100.50",
  "destination_asset_address": "0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c"
}

{
  "estimation_id": "550e8400-e29b-41d4-a716-446655440000",
  "source_asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "source_asset_amount": "100.50",
  "destination_asset_address": "0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c",
  "destination_asset_amount": "95.25",
  "trade_rate": "0.952500",
  "destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "deposit_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "expiration_time": "2024-01-15T10:30:00Z"
}

{
  "estimation_id": "550e8400-e29b-41d4-a716-446655440000",
  "payment_transaction_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}

{
  "trade_id": "550e8400-e29b-41d4-a716-446655440000"
}

// Step 1: estimate
const estimate = await fetch(`${baseUrl}/api/v1/fx/estimate`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'X-User-Wallet': userEoaAddress,
    'X-Chain-Id': chainId,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    source_asset_address: sourceTokenAddress,
    source_asset_amount: '100.50',
    destination_asset_address: destinationTokenAddress
  })
}).then(r => r.json());

// Step 2: pay destination_address on-chain, then take the hash
const paymentTransactionHash = await sendTokens(
  estimate.destination_address,
  estimate.source_asset_amount
);

// Step 3: execute
const trade = await fetch(`${baseUrl}/api/v1/fx`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'X-User-Wallet': userEoaAddress,
    'X-Chain-Id': chainId,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    estimation_id: estimate.estimation_id,
    payment_transaction_hash: paymentTransactionHash
  })
}).then(r => r.json());

headers = {
    "Authorization": f"Bearer {access_token}",
    "X-User-Wallet": user_eoa_address,
    "X-Chain-Id": chain_id,
    "Content-Type": "application/json"
}

# Step 1: estimate
estimate = requests.post(
    f"{base_url}/api/v1/fx/estimate",
    headers=headers,
    json={
        "source_asset_address": source_token_address,
        "source_asset_amount": "100.50",
        "destination_asset_address": destination_token_address
    }
).json()

# Step 2: pay destination_address on-chain, then take the hash
payment_transaction_hash = send_tokens(
    estimate["destination_address"],
    estimate["source_asset_amount"]
)

# Step 3: execute
trade = requests.post(
    f"{base_url}/api/v1/fx",
    headers=headers,
    json={
        "estimation_id": estimate["estimation_id"],
        "payment_transaction_hash": payment_transaction_hash
    }
).json()

// Step 1: estimate
estimateBody, _ := json.Marshal(map[string]string{
    "source_asset_address":      sourceTokenAddress,
    "source_asset_amount":       "100.50",
    "destination_asset_address": destinationTokenAddress,
})

req, _ := http.NewRequest("POST", baseURL+"/api/v1/fx/estimate", bytes.NewReader(estimateBody))
req.Header.Set("Authorization", "Bearer "+accessToken)
req.Header.Set("X-User-Wallet", userEoaAddress)
req.Header.Set("X-Chain-Id", chainId)
req.Header.Set("Content-Type", "application/json")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

var estimate FxEstimateResponse
json.NewDecoder(resp.Body).Decode(&estimate)

// Step 2: pay estimate.DestinationAddress on-chain, then take the hash
paymentTransactionHash := sendTokens(estimate.DestinationAddress, estimate.SourceAssetAmount)

// Step 3: execute
executeBody, _ := json.Marshal(map[string]string{
    "estimation_id":            estimate.EstimationId,
    "payment_transaction_hash": paymentTransactionHash,
})

req, _ = http.NewRequest("POST", baseURL+"/api/v1/fx", bytes.NewReader(executeBody))
req.Header.Set("Authorization", "Bearer "+accessToken)
req.Header.Set("X-User-Wallet", userEoaAddress)
req.Header.Set("X-Chain-Id", chainId)
req.Header.Set("Content-Type", "application/json")

resp, _ = http.DefaultClient.Do(req)
defer resp.Body.Close()

var trade FxExecuteResponse
json.NewDecoder(resp.Body).Decode(&trade)

{
  "error_reason": "ErrorInvalidField",
  "error_description": "Request failed validation",
  "error_category": {
    "category": "CategoryValidationFailure",
    "http_status_code": 400
  },
  "error_details": [
    { "key": "amount", "details": "Only one of source_asset_amount or destination_asset_amount can be provided" }
  ]
}