---
title: "Build a limit-order replacement transaction."
method: POST
path: "/swap/limit/{order_id}/replace"
tags: ["Swap"]
---

# Build a limit-order replacement transaction.

`POST /swap/limit/{order_id}/replace`

## Path parameters

- `order_id` string, required — Order identifier derived losslessly from the on-chain protocol hash

## Request body

- ReplaceLimitOrderRequest
  - `chain` string, required — Canonical chain registry name
  - `vault_address` string, required — EIP-55 checksummed EVM address
  - `boring_swapper` string, required — EIP-55 checksummed EVM address
  - `new_order` ReplaceLimitOrderDetails, required
    - `adapter` string, required — EIP-55 checksummed EVM address
    - `token_in` string, required — EIP-55 checksummed EVM address
    - `token_out` string, required — EIP-55 checksummed EVM address
    - `amount_in` string, required — Total replacement input offered in human-readable token_in units.
    - `amount_out` string, required — Total output required for a complete replacement fill in human-readable token_out units.
    - `valid_to` integer, required
    - `protocol_parameters` LimitOrderProtocolParams
      - `partially_fillable` boolean — Requested partial-fill mode. Must match the mode supported by the selected adapter.
      - `allow_any_sender` boolean — OpenOcean only. Allow any solver to fill the order.
      - `allowed_sender` string — EIP-55 checksummed EVM address
  - `strategist_address` string, required — EIP-55 checksummed EVM address
  - `skip_sim` boolean

## Response `200`

Successful Response

- ReplaceLimitOrderResponse — unresolved $ref

## Other responses

- `401` — Unauthorized — missing or malformed Authorization header.
- `403` — Forbidden — API key invalid, revoked, expired, or insufficient permissions for this action or resource.
- `422` — Validation Error
- `429` — Too Many Requests - Rate limit exceeded

## Changes

- **2026-09-17** `feac2b28887c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/veda/apis/veda-console-api/changes/swap/limit/:order_id/replace/post.md)

---

[API](https://skmtc.dev/veda/apis/veda-console-api.md) · [All operations](https://skmtc.dev/veda/apis/veda-console-api/llms.txt) · [OpenAPI document](https://skmtc.dev/veda/apis/veda-console-api/revisions/be52be7468d2?raw)