Skip to content

docs: hosted-default positioning + 11 new pages + READMEs + changelog (v2.49.1)#977

Merged
realfishsam merged 1 commit into
mainfrom
docs/hosted-trading-positioning
Jun 8, 2026
Merged

docs: hosted-default positioning + 11 new pages + READMEs + changelog (v2.49.1)#977
realfishsam merged 1 commit into
mainfrom
docs/hosted-trading-positioning

Conversation

@realfishsam

Copy link
Copy Markdown
Contributor

Positioning-shift patch on top of v2.49.0. Flips the docs default from local-sidecar-first to hosted-PMXT-first; self-hosting becomes the advanced escape hatch.

What's in this PR

11 new MDX pages (Mintlify): trading-quickstart, concepts/hosted-trading, concepts/hosted-vs-self-hosted, concepts/catalog-uuid-vs-venue-id, guides/escrow-lifecycle, guides/signing, guides/hosted-errors, guides/migrate-to-hosted-trading, guides/self-hosted, api-reference/errors, api-reference/configuration. Use-case-first headings, Python/TS/curl code groups, inline Warning/Note callouts.

7 prose edits: introduction.mdx (inverted "It runs two ways"), authentication.mdx (Hosted-writes subsection + SDK-exception column), security.mdx (Warning → Note), sdk/server.mdx (top banner), concepts/venues.mdx (Hosted-trading venues table), docs.json (new sidebar groups + redirects scaffold).

3 READMEs flipped to hosted-default: root pmxt readme.md, sdks/python/README.md (PyPI), sdks/typescript/README.md (npm). Self-hosted preserved as "advanced" subsection.

changelog.md: 2.49.1 entry covering the whole positioning batch.

Sibling PR

OpenAPI schema fixes ship separately on core/openapi-hosted-trading-fields (Order/UserTrade/Position/Balance enrichment fields, Position required-list trim, ErrorDetail expansion, ExchangeOptions schema). Marketing site fixes ship in pmxt-website.

Test plan

  • Mintlify preview renders all 11 new pages
  • Sidebar shows new "Hosted Trading" + "Self-host" groups
  • README content renders correctly on PyPI / npm post-release

@mintlify

mintlify Bot commented Jun 8, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
PMXT 🟢 Ready View Preview Jun 8, 2026, 8:01 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

…ython + TS SDK READMEs (2.49.1)

Flips the three pmxt READMEs to lead with the hosted API
(pmxt.dev/dashboard key + wallet_address + private_key constructor)
and demotes the self-hosted sidecar to an "advanced" subsection.
Mirrors the v2.49.0 positioning shift the docs site is doing in parallel.

- readme.md: subtitle, "Why pmxt?" bullets (dropped "No API key required"
  anti-positioning bullet), Quickstart, Trading section, added new
  "Self-hosted" section.
- sdks/python/README.md (rendered on PyPI): flipped top Note, Quick Start
  now uses pmxt_api_key + wallet_address, "How it works" split into
  hosted/self-hosted, "Authentication (for Trading)" renamed to "Trading"
  with hosted-recommended/self-hosted-advanced subsections.
- sdks/typescript/README.md (rendered on npm): same treatment in TS,
  added EthersSigner note.
- changelog.md: 2.49.1 entry covering the whole positioning-shift batch
  (READMEs + Mintlify docs + openapi schemas + marketing site, each
  shipping in its own PR).
@realfishsam realfishsam force-pushed the docs/hosted-trading-positioning branch from 2c3b8b8 to a377902 Compare June 8, 2026 20:13
@realfishsam realfishsam merged commit 805c3b4 into main Jun 8, 2026
8 of 11 checks passed
@realfishsam realfishsam deleted the docs/hosted-trading-positioning branch June 8, 2026 20:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant