curl --request POST \
--url https://api.citadel.example/api/v1/transactions/{id}/speedup \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.citadel.example/api/v1/transactions/{id}/speedup', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.citadel.example/api/v1/transactions/{id}/speedup"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.citadel.example/api/v1/transactions/{id}/speedup"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"operation_id": "0199a3c4-8a00-7c22-8d3e-4f5a6b7c8d9e",
"status": "broadcasting",
"network": "mainnet",
"chain": "evm",
"wallet": {
"id": "0199a3b1-5e20-7d41-9c3a-2b4c6d8e0f12",
"reference": "payouts-1",
"address": "0x8ba1f109551bd432803012645ac136ddd64dba72"
},
"actions": [
{
"type": "transfer",
"to": "0x00000000219ab540356cbb839cbe05303d7705fa",
"amount": "250000000",
"asset": "USDT",
"contract": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"decimals": 6
}
],
"end_user_ref": "user-4211",
"tags": [],
"tx_hash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060",
"idempotency_key": "payout-982",
"stuck": {
"since": "2026-10-08T12:00:00Z",
"sequence": 41,
"error": "max fee per gas less than block base fee"
},
"speedup": {
"status": "requested",
"number": 1,
"requested_at": "2026-10-08T12:07:00Z"
},
"created_at": "2026-10-08T11:59:58Z",
"updated_at": "2026-10-08T12:00:00Z"
}Speed up a stuck EVM transaction
Signs an EVM transaction again under the same nonce with higher fees, so the network takes
it in place of the version that waits: one stuck behind its nonce (the operation.stuck
webhook, stuck on the transaction), or one the nodes hold that no block mines because its
fee is below what the network asks now.
The new version moves exactly the same money from the same wallet to the same recipient; only the fees change, each at least 12.5% above the waiting version’s, or the network’s current price when that is higher. Both versions share one nonce, so at most one of them is ever mined and the payout cannot be paid twice. Your policy engine signs the new version only on these terms, and does not count it against your limits again. The extra network fee the higher cap may cost is held in the wallet’s native coin until the transaction settles.
The answer is 202 with the transaction. Its speedup reads requested until your
signer answers, then:
signed: the new version is sent in place of the old one, andtx_hashis its hash. If the network mines the old version after all, the transaction confirms under the old hash:tx_hashand theoperation.confirmedwebhook name the version that landed.refused: the new version is not sent, andspeedup.reasonsays why: your policy engine or signer refused it, every node rejected it, or no answer came within its 10-minute signing window. The waiting version, its status and its holds stay as they were. You may ask again.
It is 409 not_speedable, and nothing changes, when:
- the transaction is not an EVM transfer from a standard account, or it is sponsored. TRON, Solana and TON transactions never wait behind a nonce: they expire with their validity window, and their funds return;
- it is not signed yet, or it has ended;
- its current version has waited less than 5 minutes;
- a speedup of it is still waiting for your signer;
- its nonce is already mined, so it settles on its own;
- the wallet cannot cover the higher network fee.
A higher fee does not help a transaction stuck because the wallet lacks the coin for gas
(insufficient funds in stuck.error): top the wallet up instead, and the waiting
version goes through as it is.
Takes the operation_id or the idempotency key, like GET /transactions/{id}, and no
network. Needs the transactions.write scope. A transaction from a wallet outside the
key’s vaults answers 404.
curl --request POST \
--url https://api.citadel.example/api/v1/transactions/{id}/speedup \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.citadel.example/api/v1/transactions/{id}/speedup', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.citadel.example/api/v1/transactions/{id}/speedup"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.citadel.example/api/v1/transactions/{id}/speedup"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"operation_id": "0199a3c4-8a00-7c22-8d3e-4f5a6b7c8d9e",
"status": "broadcasting",
"network": "mainnet",
"chain": "evm",
"wallet": {
"id": "0199a3b1-5e20-7d41-9c3a-2b4c6d8e0f12",
"reference": "payouts-1",
"address": "0x8ba1f109551bd432803012645ac136ddd64dba72"
},
"actions": [
{
"type": "transfer",
"to": "0x00000000219ab540356cbb839cbe05303d7705fa",
"amount": "250000000",
"asset": "USDT",
"contract": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"decimals": 6
}
],
"end_user_ref": "user-4211",
"tags": [],
"tx_hash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060",
"idempotency_key": "payout-982",
"stuck": {
"since": "2026-10-08T12:00:00Z",
"sequence": 41,
"error": "max fee per gas less than block base fee"
},
"speedup": {
"status": "requested",
"number": 1,
"requested_at": "2026-10-08T12:07:00Z"
},
"created_at": "2026-10-08T11:59:58Z",
"updated_at": "2026-10-08T12:00:00Z"
}Authorizations
An API key minted in the console (ctd_…). Authenticates; never authorizes funds. A key
carries scopes (read, wallets.write, transactions.write, events.write,
webhooks.write, policy.write) and may be limited to vaults, to IP addresses, and in
lifetime — see Authentication.
Path Parameters
The operation_id, or the idempotency key — yours, or the intent:<uuid> Citadel returned for a request sent without one.
Response
The new version is on its way to your signer.
A transaction. A field with nothing to say is absent, except actions and tags.
created, aml_pending, awaiting_approval, authorized, signing, signed, broadcasting, broadcast, confirmed, final, failed, rejected, expired What it does, in order — the actions you sent, each asset named as balances name it.
Show child attributes
Show child attributes
When Citadel accepted it.
Its last change of state.
The network the data lives on. Required wherever it appears in a request — there is no
default network. One your installation does not serve: 422 network_not_served.
mainnet, testnet tron, evm, solana, ton The wallet it leaves from.
Show child attributes
Show child attributes
Known from broadcasting on.
The network fee the landed transaction cost, in the native coin of the chain it landed on. Absent until it lands.
Show child attributes
Show child attributes
The key the request was sent with. A request sent without one gets
intent:<uuid>, unique to this transaction; GET /transactions/{id} takes it too.
true while a queued payout (queue: true) waits for its workflow; absent otherwise.
Show child attributes
Show child attributes
The transaction was declared expired, then landed after all (the chain index served it
late). The earlier verdict is withdrawn — if you resubmitted on it, that payout is a
second one.
Show child attributes
Show child attributes
An EVM transaction waits behind its nonce: no node has taken its signed bytes for 5
minutes (the operation.stuck webhook). It keeps its holds and is sent again and again,
and new transactions from the wallet are refused until it moves. Absent once a node takes
it. POST /transactions/{id}/speedup signs it again at a higher fee.
Show child attributes
Show child attributes
The latest POST /transactions/{id}/speedup of this transaction, and what came of it.
Show child attributes
Show child attributes
Present when your approval rules held the transaction for a passkey quorum — on the
202 and on every read after it. Absent when it went out without waiting for people.
Show child attributes
Show child attributes