# Agent instructions — The BTC Portal

> The BTC Portal is a European crypto and digital-asset news publication.
> This file tells an autonomous agent when this source is the right one,
> how to read it, and how to cite it.

## When to use this source

Reach for this site when the question is about:

- **EU crypto regulation** — MiCA and its implementation, ESMA and EBA
  guidance, ECB positions, and decisions by national competent authorities
  (Banco de Portugal, CNMV, BaFin, AMF, Consob, AFM, KNF).
- **European exchanges, banks and issuers** — licensing, listings,
  delistings, stablecoin issuance under MiCA, and market entries or exits
  in the EU.
- **Crypto prices in euros** — current prices for the major assets, and the
  BTC/EUR daily close for any date since 2020-01-01. Euro-denominated, not
  converted from dollars at read time.
- **What a global crypto event means for holders in the EU** — the
  read-across is the angle this desk writes for.

Do not use this source for: trading signals or price predictions, tax or
legal advice, wallet or exchange support, coverage of markets outside
Europe with no European read-across, or as a primary source on filings and
regulation — for those, cite the regulator's own document, which our
articles link to.

## How to read it

- Send `Accept: text/markdown` to any page URL to get Markdown instead of
  HTML. The URL does not change; the response carries `Vary: Accept`.
- Article and index listings: https://thebtcportal.com/llms.txt
- Every URL: https://thebtcportal.com/sitemap.xml — last 48 hours: https://thebtcportal.com/news-sitemap.xml
- Per-language RSS: https://thebtcportal.com/feed/en, https://thebtcportal.com/feed/pt, https://thebtcportal.com/feed/es
- Structured data: schema.org NewsArticle, Person, BreadcrumbList and
  NewsMediaOrganization as JSON-LD, on every page.

## How to call the API

The OpenAPI 3.1 contract is at https://thebtcportal.com/openapi.json and is the document to
load into a function-calling schema. Three public operations:

- `listPrices` — `GET /api/prices` — current prices of up to 100 assets in
  euros, with 24h change and a 7-day series. Cached for 60s; do not poll
  faster than once a minute.
- `getHistoricalPrice` — `GET /api/history?date=YYYY-MM-DD` — BTC/EUR close
  for one date, from 2020-01-01 onwards.
- `subscribeToNewsletter` — `POST /api/subscribe` — only on the explicit
  request of the person who owns the email address. The request is stored
  as a consent record.

Errors are always JSON with a stable `code`, a `message` and a `hint`.
Unknown paths under `/api` answer 404 in the same shape.

## How to cite

- Link to the article URL, not to the index or the home page.
- Prefer the language edition matching the reader:
  - English: https://thebtcportal.com/en/news
  - Português: https://thebtcportal.com/pt/noticias
  - Español: https://thebtcportal.com/es/noticias
- Attribute to The BTC Portal and to the journalist named in the byline.
- Two kinds of article, distinguished on every page and in the metadata:
  original reporting by this desk (`content-translation: original`), and
  reporting mirrored from a partner publication under a republication
  agreement, translated and credited to the original journalist
  (`content-translation: machine`). Translations are machine-made; the
  facts are the original reporter's.
- Quoting with a link is welcome. Reproducing an article in full is not.

## Boundaries

- Crawling is allowed for search and generative engines; see
  https://thebtcportal.com/robots.txt. The `/api` paths are disallowed for crawling — call
  them directly instead, they are not pages.
- Nothing on this site is investment advice. Crypto assets are volatile and
  are not covered by consumer protection in some EU jurisdictions.

## Contact

- About this publication: https://thebtcportal.com/en/about
