---
title: "Changes to Swap Tokens"
method: POST
path: "/v1/wallets/{wallet_id}/swap"
---

# Changes to Swap Tokens

`POST /v1/wallets/{wallet_id}/swap`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 46 revisions.

- **2026-06-26** `c10a42ebeddb` — 1 breaking, 6 info
- **2026-06-23** `9955c27139f3` — 1 breaking, 1 info
- **2026-06-16** `8f9eb26a2248` — 1 info
- **2026-06-12** `a8d27de9e15d` — 1 breaking, 5 info
- **2026-06-09** `02e9839a74d4` — 6 info
- **2026-06-08** `93c7790da9d3` — 6 breaking
- **2026-06-05** `2e6aabd41a3c` — 1 breaking, 2 warning
- **2026-06-03** `b64a233ab9ee` — 4 info
- **2026-05-29** `59011037f125` — 3 info

## Changes

- **2026-06-26** `c10a42ebeddb` — 1 breaking, 6 info
  - the `steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version` response's property type changed from `string` to no type for status `200`
  - added the new optional `header` request parameter `privy-request-expiry`
  - added `#/components/schemas/EVMUserOperationEntrypointVersion, subschema #2` to the `steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version` response property `allOf` list for the response status `200`
  - removed the `0.6` enum value from the `steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version` response property for the response status `200`
  - removed the `0.7` enum value from the `steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version` response property for the response status `200`
  - removed the `0.8` enum value from the `steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version` response property for the response status `200`
  - removed the `0.9` enum value from the `steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version` response property for the response status `200`
- **2026-06-23** `9955c27139f3` — 1 breaking, 1 info
  - added `#/components/schemas/TVMTransactionWalletActionStep` to the `steps/items/` response property `oneOf` list for the response status `200`
  - added `tvm_transaction` discriminator mapping keys to the `steps/items/` response property for the response status `200`
- **2026-06-16** `8f9eb26a2248` — 1 info
  - added the optional property `destination_address` to the response with the `200` status
- **2026-06-12** `a8d27de9e15d` — 1 breaking, 5 info
  - added `#/components/schemas/CustodianTransactionWalletActionStep` to the `steps/items/` response property `oneOf` list for the response status `200`
  - added the optional property `steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/finalized` to the response with the `200` status
  - added the optional property `steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/finalized` to the response with the `200` status
  - added the optional property `steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/finalized` to the response with the `200` status
  - added `custodian_transaction` discriminator mapping keys to the `steps/items/` response property for the response status `200`
  - removed the `finalized` enum value from the `steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/status/allOf[subschema #1: SVMWalletActionStepStatus]/` response property for the response status `200`
- **2026-06-09** `02e9839a74d4` — 6 info
  - added the optional property `steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd` to the response with the `200` status
  - added the optional property `steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd` to the response with the `200` status
  - removed `#/components/schemas/Gas, subschema #2` from the `estimated_gas` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/Gas, subschema #2` from the `gas` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Gas, subschema #2` to the `estimated_gas` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/Gas, subschema #2` to the `gas` response property `anyOf` list for the response status `200`
- **2026-06-08** `93c7790da9d3` — 6 breaking
  - the response property `estimated_fees` became nullable for the status `200`
  - the response property `estimated_gas/allOf[subschema #2]/` became nullable for the status `200`
  - the response property `fees` became nullable for the status `200`
  - the response property `gas/allOf[subschema #2]/` became nullable for the status `200`
  - the `estimated_gas/allOf[subschema #2]/` response's property type changed from no type to `object, null` for status `200`
  - the `gas/allOf[subschema #2]/` response's property type changed from no type to `object, null` for status `200`
- **2026-06-05** `2e6aabd41a3c` — 1 breaking, 2 warning
  - the `slippage_bps` request property type changed from `number` to `integer`
  - the `slippage_bps` request property's max was set to `10000.00`
  - the `slippage_bps` request property's min was set to `0.00`
- **2026-06-03** `b64a233ab9ee` — 4 info
  - added the optional property `estimated_fees` to the response with the `200` status
  - added the optional property `estimated_gas` to the response with the `200` status
  - added the optional property `fees` to the response with the `200` status
  - added the optional property `gas` to the response with the `200` status
- **2026-05-29** `59011037f125` — 3 info
  - added the new optional request property `destination/destination_address`
  - added the new optional request property `fee_configuration`
  - added the optional property `destination_caip2` to the response with the `200` status

---

[Operation](https://skmtc.dev/privy-io/apis/privy-api/docs/v1/wallets/:wallet_id/swap/post.md) · [API](https://skmtc.dev/privy-io/apis/privy-api.md) · [Page](https://skmtc.dev/privy-io/apis/privy-api/changes/v1/wallets/:wallet_id/swap/post)