Submit a Swap

Build and execute the public swap flow: Build -> Get signing -> Submit signed artifact.

Use this flow after POST /quote. The SDK exposes these methods:

• Layer-based: sdk.swap.build, sdk.swap.getSigning, sdk.swap.submitSigning
• Flat: sdk.buildSwap, sdk.getSwapSigning, sdk.submitSwapSigning

---

Build swap

build

Calls POST /swap/build.

Parameters

• body (SwapBuildRequest, required)

  • quoteId (string, required)
  • routeId (string, required)
  • recipient (string, required)
  • waitForTxRequestMs (number, optional)

Returns

A Promise that resolves to SwapBuildResponse.

• data.swapId (string)
• data.mode ("sync" or "async")
• data.nextAction ("sign" or "poll")
• data.pollAfterMs (number, optional)
• data.signing (signing payload + hints)
• meta.requestId (string): Request identifier.
• meta.timestamp (string): Response timestamp.

---

Get signing status

getSigning

Calls GET /swap/{swapId}/signing.

Parameters

• swapId (string, required)

Returns

A Promise that resolves to SwapSigningResponse with the same top-level shape as build (swapId, mode, nextAction, pollAfterMs, signing).

---

Submit signed artifact

submitSigning

Calls POST /swap/{swapId}/signing.

Parameters

• swapId (string, required)
• body (SwapSubmitSigningRequest, required)

  • rawTx (string, required): Signed transaction artifact.

Returns

A Promise that resolves to SwapSigningResponse (typically nextAction: "poll" while next step is preparing).

import { RoutingEngineSDK } from 'routing-engine-sdk';

const sdk = new RoutingEngineSDK({
  api: { apiKey: 'your-api-key' },
});

try {
  const quote = await sdk.quote.request({
    fromChain: 'arbitrum',
    toChain: 'avax',
    tokenIn: 'TBTC',
    tokenOut: 'WETH',
    network: 'mainnet',
    amount: '100.00',
    slippageBps: 75,
    recipient: '0x1234567890123456789012345678901234567890',
  });

  const build = await sdk.swap.build({
    quoteId: quote.data.quoteId,
    routeId: quote.data.routes[0].routeId,
    recipient: '0x1234567890123456789012345678901234567890',
  });

  const signing = await sdk.swap.getSigning(build.data.swapId);
  if (signing.data.nextAction === 'sign') {
    // Sign with wallet/signer, then submit the signed raw transaction.
    await sdk.swap.submitSigning(build.data.swapId, { rawTx: '0xsigned_raw_tx' });
  }
} catch (error) {
  console.error(error);
}