Stage B · Agent-based simulation
In a crisis digital money
How to use it?
- Choose the parameters, then press Setup .
- Run / stop to proceed. The crisis news arrives from step 10 onwards.
- Keep the same random seed, change one parameter, and set up the model again.
Amounts are model units; one step is not a day or an hour. All starting figures and behavioural coefficients are illustrative.
Try the model
Green cells shift towards CBDC, bronze cells towards cash. The colour of the banks changes with reserve stress. The graph shows the totals for deposits, CBDC and cash.
Download the NetLogo model · Method and assumptions · Experiment outputs
On narrow screens you can scroll down to the controls. The large network view is easier to examine on a desktop.
Three comparisons
- CBDC on / off: compare the payment options under the same crisis, seed and cash capacity.
- Limit 10 / 50 / unlimited: keep the other settings fixed. Look at the deposit graph, the shift to cash and the households at the limit.
- Social influence 0 / 0.8: examine how neighbours' decisions spread at the same crisis intensity.
What is happening inside?
- Initial state: each household receives 80 to 120 units of deposits and a different decision threshold. The share of bank deposits you select starts as reserves, and the remainder as fixed loan assets.
- News and neighbours: the crisis news takes effect from step 10. The household considers the intensity of the news, its neighbours who converted in the previous step, and bank stress.
- Choice: CBDC access, the gap to the limit and the privacy/redress scenario affect the target instrument. If CBDC is not chosen, cash becomes the alternative.
- Realisation: The decision does not mean the conversion has taken place. The bank reserve, the CBDC limit and the cash service quota limit the amount.
- Feedback: conversion reduces both deposits and reserves. When the reserve-to-deposit ratio falls below 8%, the bank is treated as stressed; this information feeds into the decision at the next step.
What does each indicator say?
| Indicator | How to read it |
|---|---|
| Deposits, CBDC, cash | Shows in which instrument household wealth is held. The sum of the three is conserved. |
| Stressed banks | The number of banks whose reserve-to-deposit ratio is below the 8% threshold in the model. It is not an indicator of actual bank failure. |
| Share at the limit | The proportion of households that have reached the CBDC holding limit. When the limit is 0, this indicator counts everyone as at the limit; it should not be read as CBDC usage. |
| Unmet conversion at this step | The difference between the conversion demand at that step and the amount actually realised. It is not a cumulative loss or a count of unique individuals. |
Where does the gap in a chart come from?
This version assumes faster transfers to CBDC than to cash. Comparing CBDC on/off changes both instrument availability and transfer speed. The mechanism audit below tests this difference separately under equal transfer conditions.
Because no new liquidity arrives from the central bank, total conversion is limited by the initial reserve. A higher CBDC limit therefore does not always produce more conversion. When interpreting the chart, the behavioural rule and this accounting constraint should be read together.
A 120-step horizon may end the cash channel early: in a separate validation experiment with the same start, when the run was extended to 480 steps, cash outflows also reached the reserve ceiling. Because bank assignment and the retail network are tied to the same index, social spread within banks should be tested separately.
Model assumptions
Households take into account the neighbours' behaviour in the previous step and bank stress. Conversion is limited by bank reserves. Once the limit is reached, cash remains as the alternative. In this version, digital conversion is assumed to be faster than cash service; cash capacity is a separate control.
The interest rate switch only changes the attractiveness of preferences; it does not accrue interest. Privacy and redress options are hypothetical designs.
Credit assets are held fixed. Deposit insurance, central bank liquidity support, asset sales and interbank transfers are not present in this version. Model results should be read together with these assumptions.
Rules or behaviour?
The new mechanism audit matches 40 experimental cells on the same eight initial populations: 320 NetLogo runs. We equalised cash-transfer conditions, separately removed the addition of CBDC appeal to withdrawal propensity, and extended the horizon from 120 to 480 steps.
| Regime | 120 steps | 480 steps |
|---|---|---|
| Original slow cash | 5.58% | 20.00% |
| Fast cash without a quota | 20.00% | 20.00% |
| CBDC with equal conditions; appeal decoupled from withdrawals | 20.00% | 20.00% |
At a high limit, aggregate outflow can be identical while its allocation between cash and CBDC differs. A limit of 10 also changes short-run speed and asset composition. Initial reserves set the ceiling here; a more comprehensive financial-system model may produce different results.
Download the 320-run data · Code, raw outputs and reproduction bundle
Method and replication
At every step, the model checks the conservation of household wealth, central bank monetary liabilities and bank balance sheets. The 150-condition limit × crisis scan was run with 10 different seeds. The code, parameter table and experiment definition are included in the downloadable method file.
The model code is MIT licensed. NetLogo and the web runtime are subject to their own licences. Model licence.
Sources
- Wilensky, U. (1999). NetLogo. Northwestern University. Official documents.
- Grimm et al. (2020). The ODD Protocol for Describing Agent-Based and Other Simulation Models. JASSS 23(2),7. Article.
- IMF (2025). Evaluating the Implications of CBDC for Financial Stability. Report.
- Barucci, Gurgone, Iori and Azzone. Central Bank Digital Currency, Flight-to-Quality, and Bank-Runs in an Agent-Based Model. 2025 preprint; 2026 working paper. Open text and version record.
- TCMB (2025). Digital Turkish Lira Second Phase Progress Report. Turkey guide.



