majjha.developers
Open beta

Public beta: activity uses test Dots with no monetary value. There is no money in or out, and interfaces may change before launch.

Environments

Point your client at the hosted public beta, or run the same API locally for development.

Test activity only

Dots in the hosted beta have no monetary value. The consumer app has no deposit or withdrawal flow, and the service is not a production money environment.

Base URLs

Hosts
hosted beta  https://api.majjha.fun          REST
             wss://api.majjha.fun/ws          WebSocket

local dev    http://localhost:7890                REST
             ws://localhost:7890/ws               WebSocket

Public market data needs no authentication. Private account, portfolio, and order-management endpoints require a majjha Bearer token.

One account model

The first-party app uses Dynamic for account sign-in. Private APIs use the majjha session returned after that sign-in, while locally created accounts can use email and password.

  • Public data: markets, books, and price feeds are open to everyone.
  • Private data: account and portfolio resources require a Bearer token.
  • Beta balance: test Dots have no monetary value and cannot move into or out of the app.
  • Local development: the engine exposes the same API at localhost:7890.

Develop locally, target the hosted beta

Run the engine locally while building your integration, then point the same client at the hosted beta when you are ready to exercise the deployed service.

Same read request, either host
# local
curl "http://localhost:7890/api/markets?status=ACTIVE&limit=5"

# hosted beta
curl "https://api.majjha.fun/api/markets?status=ACTIVE&limit=5"
PreviousSDKsNext Authentication