Commands, events & scheduling

php artisan money:currencies --custom

php artisan money:rates:refresh                     # ECB daily feed into the rates table
php artisan money:rates:refresh ecb --feed=recent   # the last 90 days
php artisan money:rates:refresh ecb --feed=history --from=2020-01-01 --to=2020-12-31
php artisan money:rates:refresh --queue             # dispatch a unique queued job instead
php artisan money:rates:refresh --isolated          # keep overlapping runs out

php artisan money:rates:prune --keep-days=365 --pretend   # only count
php artisan money:rates:prune --before=2024-01-01 --include-manual

php artisan money:convert 19.99 EUR USD
php artisan money:convert 19.99 EUR USD --date=2026-09-01 --driver=database

use RoundlyConsulting\Money\Enums\EcbFeed;
use RoundlyConsulting\Money\Facades\Exchange;
use RoundlyConsulting\Money\Jobs\RefreshExchangeRates;

Exchange::rates()->refreshLater(feed: EcbFeed::Recent);   // queue the refresh

// the same job, dispatched yourself: source, feed, ?from, ?to (Y-m-d)
dispatch(new RefreshExchangeRates('ecb', 'recent'));

use RoundlyConsulting\Money\Enums\EcbFeed;
use RoundlyConsulting\Money\Facades\Exchange;

$result = Exchange::rates()->refresh('ecb', EcbFeed::Recent);   // RefreshResult
$result->stored;                   // rows written
$result->skippedManual;            // manual rows left untouched
$result->skippedUnknownCurrency;   // feed currencies the registry does not know
$result->latestDate;               // ?CarbonImmutable

$deleted = Exchange::rates()->prune(now()->subYear());          // int

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Money\Events\ExchangeRatesRefreshed;
use RoundlyConsulting\Money\Events\ExchangeRatesRefreshFailed;

Event::listen(function (ExchangeRatesRefreshed $event) {
    logger()->info('Exchange rates refreshed', [
        'source' => $event->result->source,
        'stored' => $event->result->stored,
        'latest' => $event->result->latestDate?->toDateString(),
    ]);
});

Event::listen(function (ExchangeRatesRefreshFailed $event) {
    // alert your team: $event->source, $event->message — existing rows are untouched
});