Developers

Developers and agents

Everything public on platformd.io can be read programmatically. This page is the reference for developers and AI agents.

One thing to state plainly first: there is no public transactional API, no API keys, and no self-service sandbox yet. PlatformD is an entrant in the joint Bank of England and FCA Digital Securities Sandbox, and live issuance of digital securities begins once the Bank of England confirms the next sandbox gate, targeted for early 2027. Until then, the resources below are the supported ways to read this site by machine. Do not infer pricing, yield or volume figures: none are published.

Machine-readable resources

  • Site overview and agent guidance: /llms.txt. Start here. It explains what PlatformD is, when an agent should use this site, and how to read it.
  • OpenAPI description of the public surface: /openapi.json. An OpenAPI 3.1 document describing every public machine-readable endpoint, including the error format.
  • Sitemap: /sitemap.xml. Every indexable page with last-modified dates.
  • Insights post metadata: /insights/chunks/1.json. Paginated JSON metadata (title, description, date, author, tags) for the Insights articles.

Markdown content negotiation

The homepage, the Insights index, every Insights post and this page are served as clean markdown when a request prefers it:

curl -H "Accept: text/markdown" https://platformd.io/

Markdown responses carry Content-Type: text/markdown; charset=utf-8 and Vary: Accept. The same documents are also addressable directly, without negotiation:

  • /md/home: the homepage
  • /md/insights: the Insights index
  • /md/developers: this page
  • /md/post/{slug}: any Insights post

Structured errors

Machine-facing paths return JSON errors with a code, a message and a resolution hint:

{
  "error": {
    "status": 404,
    "code": "not_found",
    "message": "No resource exists at this path.",
    "hint": "Available resources are listed at https://platformd.io/openapi.json."
  }
}

Requests under /api/ return this format today, because no public transactional API exists yet. Nonexistent pages return a real HTTP 404, with a markdown body when the request prefers text/markdown.

Platform access

Institutional participants interested in the non-transactional pilot, and partners who want early access to the platform API when it opens, can write to info@platformd.io. Any platform data shown publicly is simulated, for demonstration.