% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/market_notices.R
\name{aemo_market_notices}
\alias{aemo_market_notices}
\title{NEM market notices}
\source{
AEMO NEMweb MMSDM archive, MARKETNOTICEDATA table.
AEMO Copyright Permissions Notice.
}
\usage{
aemo_market_notices(start, end, notice_type = NULL, region = NULL)
}
\arguments{
\item{start, end}{Window (inclusive) applied to \code{EFFECTIVEDATE}.}

\item{notice_type}{Optional character vector (e.g. \code{"LOR1"},
\code{"RERT"}, \code{"PRICES SUBJECT TO REVIEW"}). Case-insensitive
substring match.}

\item{region}{Optional NEM region code.}
}
\value{
An \code{aemo_tbl} with columns from MARKETNOTICEDATA:
\code{noticeid}, \code{effectivedate}, \code{typeid} (notice category),
\code{originator}, \code{priority}, \code{reason} (the notice text),
\code{externalreference}, and where present \code{regionid}.
}
\description{
Returns the \code{MARKETNOTICEDATA} feed from MMSDM. Market
notices are AEMO's free-text log of market-relevant events:
Lack of Reserve (LOR1/2/3) declarations, Reliability and
Emergency Reserve Trader (RERT) activations, market
suspensions, market directions, unit withdrawals, system
security events, administered price declarations, and
operator advisories.
}
\details{
Pair with \code{\link[=aemo_constraints]{aemo_constraints()}} and \code{\link[=aemo_price]{aemo_price()}} to sequence
the causal chain of a price event. Rangarajan, Svec, Foley
and Trück (2025, \emph{Energy Economics} 141) use
\code{MARKETNOTICEDATA} to order the intervention messages that
mark entry to and exit from the June 2022 NEM suspension.
}
\examples{
\donttest{
op <- options(aemo.cache_dir = tempdir())
try({
  # LOR declarations during the June 2022 NEM suspension
  n <- aemo_market_notices(
    start = "2022-06-13",
    end   = "2022-06-14",
    notice_type = "LOR"
  )
  head(n)
})
options(op)
}
}
\seealso{
Other dispatch: 
\code{\link{aemo_bids}()},
\code{\link{aemo_constraints}()},
\code{\link{aemo_dispatch_units}()},
\code{\link{aemo_fcas_enablement}()},
\code{\link{aemo_gencon}()},
\code{\link{aemo_interconnector}()},
\code{\link{aemo_outages}()},
\code{\link{aemo_rooftop_pv}()},
\code{\link{aemo_spd_constraints}()}
}
\concept{dispatch}
