Skip to main content
GET
One month of this client's marketing-fee statement

Authorizations

x-api-key
string
header
required

Path Parameters

month
string<date>
required

First day of the month (UTC).

Query Parameters

asset
string

The deployment's asset, with network: a branded token your client owns, for that deployment's yield payout statement. Absent means RD's marketing-fee statement, exactly as without it.

network
enum<string>

The deployment's network, with asset. The two are named together or not at all. Identifier for a blockchain network

Available options:
ethereum-mainnet,
ethereum-sepolia,
ethereum-goerli,
ethereum-holesky,
solana-mainnet,
solana-devnet,
solana-testnet,
base-mainnet,
base-sepolia,
arbitrum-mainnet,
arbitrum-sepolia,
optimism-mainnet,
optimism-sepolia,
polygon-mainnet,
polygon-amoy
Required string length: 1 - 30
Example:

"ethereum-mainnet"

Response

The month's statement

month
string<date>
required
y_bps_monthly
number<double>
required

The rate APPLIED to this month, in monthly basis points: the annual contract rate charged for the days this month actually has (y_bps_annual x days_in_month / 365), rounded to 2 decimal places — the precision it is charged and stored at.

Once a month has been priced, this is the rate it was priced at and a later rate change does not rewrite it. For a month not yet priced, including the running month, it is a projection from your current rate and moves if that rate changes.

y_bps_annual
number<double>
required

The CONTRACT rate, in basis points per year, as the Order Form quotes it. Stated beside the applied rate so a client can check the month was charged from the rate they signed.

days_in_month
integer
required

Calendar days in the month — the divisor, never the number of rows stored.

days_stamped
integer
required

Days whose principal is stored. Lower than days_in_month while the month is still being derived or still running, which is how a partial month is shown as partial rather than as a complete small one.

daily
object[]
required
owed_minor
string

What the month currently derives to, as a whole number of RD minor units. ABSENT until the month is priced — absent and zero are different facts, and zero means the month owes nothing payable.

This is a derived figure, not a record of payment. It is recalculated if the balance history behind the month changes, which can happen after a payment has been made, so it is not necessarily the amount that was paid. A month owes zero whenever Dakota's earned rate for it did not exceed your contract rate; the figure is never negative, and it is rounded down to a whole minor unit.

avg_daily_balance_minor
string

The mean of the month's stored daily principals. Absent while the month is incomplete.

asset
string

The deployment's asset, present on a deployment's statement only. Absent means RD's marketing-fee statement.

Example:

"ACME"

network
enum<string>

The deployment's network, present on a deployment's statement only.

Available options:
ethereum-mainnet,
ethereum-sepolia,
ethereum-goerli,
ethereum-holesky,
solana-mainnet,
solana-devnet,
solana-testnet,
base-mainnet,
base-sepolia,
arbitrum-mainnet,
arbitrum-sepolia,
optimism-mainnet,
optimism-sepolia,
polygon-mainnet,
polygon-amoy
Required string length: 1 - 30
Example:

"ethereum-mainnet"

dakota_rate_bps_monthly
number<double>

The earned rate the month was priced at, in monthly basis points: the pool's reserve interest for the month over its time-weighted reserve, one figure for every deployment. Present on a deployment's statement once the month is priced.

paid_minor
string

What has been paid for the month, in the token's minor units, on a deployment's statement. Absent when nothing has been paid: a month not yet paid is not a month paid nothing.