---
title: "Persist wallet order"
method: PUT
path: "/api/wallets/order"
tags: ["Wallets", "Wallet and web3"]
---

# Persist wallet order

`PUT /api/wallets/order`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/wallets/order`
- Auth: HTTP bearer

Edit-mode drag reorder (#888). Body `{ walletIds }`: the full ordered list of the caller's wallet ids (1..50, unique). Atomic, owner-scoped by id, idempotent, no PIN. 30 req/min/user (429 RATE_LIMITED with Retry-After).

## Request body

- object
  - `walletIds` string[], required: Full ordered list of the caller's wallet ids

## Response `200`

{ wallets } in the new display order

## Other responses

- `400`: VALIDATION_ERROR (empty array, oversized, duplicates)
- `401`: UNAUTHORIZED
- `409`: WALLET_SET_CHANGED (ids do not equal the caller's set) with current { wallets } for merge-and-retry
- `429`: RATE_LIMITED (30/min) with Retry-After
- `500`: INTERNAL_ERROR (untyped action failure)

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/wallets/order/put.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
