Environments
Every base URL on this site is rendered from a single config file. If a host changes, it changes here and everywhere at once — nothing is hardcoded in prose.
United States
| Environment | Base URL | Status |
|---|---|---|
| Integration Shared integration environment. REST, GraphQL and WebSockets all live. No real money. | demo.stxapp.io | Available |
Canada (Ontario)
| Environment | Base URL | Status |
|---|---|---|
| Integration Shared integration environment for the Canadian exchange. No real money. | api-staging.on.sportsxapp.com | Available |
| Production Live money. Point at this only once your integration is exercised end to end. | api.on.stxapp.ca | Available |
Which one should I use?
Section titled “Which one should I use?”Use demo.stxapp.io — the US Integration environment. It is the only environment
currently serving /api/v1 on a publicly reachable address, and it is shared by every
developer integrating with STX, so the order books carry real activity. No real money.
The Canadian hosts are listed for completeness but resolve to private addresses and do not yet serve the REST API.
Referring to URLs in docs
Section titled “Referring to URLs in docs”Source pages should never hardcode a host. Write a token instead and the build substitutes it:
POST {{env.ca.integration.url}}/api/v1/ordersAvailable tokens are {{env.<region>.<environment>.url}} — for example
{{env.us.integration.url}} or {{env.ca.production.url}}. An unknown token is
logged as a build warning rather than silently rendered.
Legacy hostnames already written into the source repos are rewritten to their token automatically, so existing prose stays correct without editing four repos.