> ## Documentation Index
> Fetch the complete documentation index at: https://shield.fi/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Make your first swap

> Choose an SDK or the CLI to complete your first testnet swap.

Use an SDK to add trading to an application, bot, or service. Choose the CLI to run and inspect swaps from your terminal.

Both guides walk you through preparing and funding an account, reviewing a quote, and submitting a swap. You'll then claim and verify the output.

<CardGroup cols={2}>
  <Card title="Build with an SDK" href="./first-swap/sdk">
    Write your first swap in JavaScript/TypeScript or Python. Choose a language once for the whole walkthrough.
  </Card>

  <Card title="Run from the CLI" href="./first-swap/cli">
    Run your first swap from the terminal.
  </Card>
</CardGroup>

The trade settles once the claim is accepted and the returned token records are available. If you've already submitted a swap, check its state in [Failures and recovery](./failures-and-recovery) before starting another.