Skip to content

ADR 0011: Crypto assets: scope, identity, UTC daily closes and hosted API sources

Status: accepted on 2026-11-13 by the owner. Product authority: consumer product requirements 3.1 (markdown/argus-consumer-product-requirements-3.1.md). It extends ADR 0008, which stays in force.

Context

The owner wants Argus to cover crypto assets. The review of 2026-11-12 found four things that shape how.

  1. Crypto has three kinds of source. SEC filings cover listed products that hold crypto. The chain itself states blocks, fees and token supply. Vendors state prices. Only the first two can be cited the way Argus cites a filing.
  2. SEC filings already carry coin holdings. Spot crypto exchange-traded products and listed companies report the XBRL concepts CryptoAssetNumberOfUnits, CryptoAssetFairValue and CryptoAssetCost.
  3. Bare tickers collide. BTC and ETH are tickers of funds listed on NYSE Arca, so a crypto asset cannot use them.
  4. The price path assumes US exchange sessions. The market contract, the price tools, the calendar reader and the EODHD connector fix the market to US, the time zone to New York and the close to 16:00.

On 2026-11-13 the owner decided three things: region and legal rules do not change, crypto adds no region rule of its own, and crypto data comes only from API services on the market, free where possible, with no self-run nodes.

AGENTS.md still applies: a source whose license is unknown is denied. The terms read on 2026-11-12 and 2026-11-13 gave this picture. It is research, not legal advice, and terms change.

  • PublicNode's terms allow automated access in production and showing the returned chain data to your own users. They forbid reselling it as a standalone data API.
  • No free price source read on those days clearly grants all three of: display to end users, long-term storage, and daily open-high-low-close bars. CoinMarketCap's free plan comes closest and gives daily closes only.

Decision

  1. Two forms.
  2. Securities that hold crypto (spot crypto exchange-traded products and listed companies) are treated like any other US-listed security. Their balance sheet gains three items: units held, cost and fair value.
  3. A crypto asset itself gets a daily close, on-chain facts, holdings and memory (watchlists and notes). The first version gives it no financial statements, filing search, change comparison, events or alerts.
  4. Identity. A crypto asset is written as asset code plus quote currency, for example BTC-USD, and has its own internal namespace. A bare BTC or ETH always resolves to the listed fund, with a note that points to BTC-USD. A search by name returns candidates and the user chooses.
  5. Asset list by rule. Bitcoin and Ether come first. After them the list takes only assets that have a spot exchange-traded product listed in the United States, and the major US-dollar stablecoins issued on Ethereum. The list is not a ranking by market value. Since 2026-11-17 ADR 0024 supersedes that last sentence: the list also admits the 20 largest assets by market value and the assets of US over-the-counter trusts among the 50 largest, and its order is still not a ranking.
  6. Daily bar. One bar per UTC day, bounded at 00:00 UTC. The first version requires only the close; open, high, low and volume appear when the source provides them. The freshness label is daily_close_utc, not the label used for US closes. A close older than three days is reported as stale.
  7. Price wording. Each price states its source, pair and UTC date. Argus does not call a vendor's number "the bitcoin price".
  8. On-chain facts. Each fact carries the chain, block height, block hash and block time, so anyone can check it. The chain is the publisher and the attribution names the API it was read through. Estimates (network hash rate) and calculations (scheduled issuance) are labelled as such.
  9. Sources.
  10. Only hosted API services. Argus runs no blockchain node.
  11. Every source passes Argus's license admission steps before a consumer sees it. Where the terms are silent, written confirmation from the provider comes first.
  12. For one use, the order of preference is: free with terms that clearly allow it; free with written confirmation; paid with terms that clearly allow it.
  13. On-chain facts come from PublicNode's public endpoints.
  14. The daily close source is chosen by admission. The first candidate is CoinMarketCap's free plan, after written confirmation that delivery through MCP is in-product display, that daily closes may be kept, and that the free plan falls under its commercial agreement.
  15. Futures positioning comes from the CFTC public reporting data and the EU register from ESMA, both with attribution.
  16. Regions. The existing eligibility rules apply unchanged. Crypto has no extra region rule, language limit or legal-opinion precondition.
  17. Not offered. Derivatives (perpetuals, options, leveraged tokens), DeFi yields, NFTs and long-tail tokens, token scores, sentiment indices, whale signals, price predictions, exchange keys, wallet connections, real-time or intraday prices, and vendor-estimated "fundamentals" such as protocol revenue, value locked or unlock schedules.
  18. Order. Securities-form coverage first, then on-chain facts, then the daily close, then extensions (more assets by the rule, stablecoin supply, futures positioning, the EU register).

Consequences

  • The price path gains a calendar kind: exchange sessions or UTC days. US behaviour and its tests do not change.
  • A new forward migration adds the crypto security type and the connector kind for on-chain facts. No released migration is edited.
  • If no price source passes admission, the daily close does not ship. The securities-form coverage and the on-chain facts do not depend on it.
  • PublicNode's licence is revocable, undated and has no service level. A fallback provider needs its own admission before use.
  • Public wording (site, tool descriptions, the coverage resource) changes only when each stage ships, in all six languages.
  • The no-advice output policy applies as it is. A new policy version names the crypto outputs in item 9 as prohibited.
  • Holdings of a crypto asset need fractional quantities; see ADR 0014.
  • The free plan's licence covers one product with up to 100,000 users. The license policy records that limit as a termination condition.

Amendment of 2026-11-14

The owner chose the daily close source of decision 7: CoinMarketCap's Basic (free) plan, with display allowed. It is recorded as an owner attestation, as decision D6 is for EODHD, in the license policy coinmarketcap_basic_owner_admitted_v1. The policy grants agent read, display and storage of history, never export. The source stays disabled until production holds a key, and hidden until the crypto stage ships.

Amendment of 2026-11-16

Release 1.1.40 ships stage C3 for BTC-USD and ETH-USD. The live requests of 2026-11-15 showed that the Basic plan's history has five-minute steps, so the daily value of decision 7 is the last quote of each UTC day, at 23:55 UTC, not a quote of the day's last minute. Argus stores it as the UTC daily bar of decision 4 and, under decision 5, calls it the last quote of the UTC day at 23:55 UTC, never CoinMarketCap's daily close. The on-chain facts stay hidden: no live call to PublicNode has been verified (review report 16.2).

Second amendment of 2026-11-16

Release 1.1.41 applies decision 3 for the first time beyond Bitcoin and Ether. The rule is code (src/argus/core/crypto_list_rule.py): an asset after the two needs either a US-listed spot exchange-traded trust that holds it, named with the 10-K or 10-Q in which the trust states the holding, or a US-dollar stablecoin contract on Ethereum that the chain source reads. The trusts were read from SEC EDGAR on 2026-11-16, and each is on the coverage list as an exchange-traded trust (kind: trust), so its own filings can be read through Argus. The list holds 16 assets: BTC, ETH, then AVAX, BNB, DOGE, HYPE, LINK, LTC, NEAR, SOL, SUI, TRX, XRP and ZEC by their spot trusts, then USDC and USDT, whose quotes are listed on the owner's confirmation of 2026-11-14 that they are the main US-dollar stablecoins. The order after Bitcoin and Ether is that of the codes, which states no ranking. Every asset has the daily value of decision 7 from the same CoinMarketCap source; the stablecoin supply, the futures positioning and the EU register stay hidden. The evidence for each asset is in config/crypto_list_basis.yaml; a trust whose only statement was a prospectus was left out.

Amendment of 2026-11-17

The owner approved version 4 of the list rule, recorded in ADR 0024, which supersedes the last sentence of decision 3. After Bitcoin and Ether the list may also take an asset ranked 1 to 20 by market value in a recorded CoinMarketCap listings response, and an asset that a single-asset spot trust quoted over the counter in the United States holds, if it ranks 1 to 50 in the same response. The two caps keep the long-tail tokens of decision 9 off the list. Release 1.1.43 lists 24 assets under that rule.