Skip to main content
Your Musubi integration runs on your own infrastructure with strict data isolation. The settlement network enforces visibility boundaries at the protocol level — you cannot see data you’re not authorized to see, and no one can see your data without authorization.

Authentication

PropertyValue
Token typeJWT (JSON Web Token)
Key claimscanton_party_id (your identity), role: "market-maker"
Lifetime3600 seconds (1 hour) default
Obtain viaPOST /auth/token on your backend
In production, JWT issuance integrates with your organization’s identity provider.

Data Isolation

Your backend and database run in your infrastructure. They contain only your data: No participant can access another participant’s backend or database. Communication between participants flows exclusively through the settlement network protocol.

Visibility Boundaries

The settlement network enforces what data reaches your node:
DataVisible to You
Quote requests (anonymized)Currency pair, amount, expiry
Your own quotesFull details (rate, amount, status, timestamps)
Your won settlementsSwap amounts, rate, transaction hash
Sender/receiver identityNever
Other MMs’ quotesNever
Other MMs’ settlementsNever
Compliance data (KYC refs, jurisdiction)Never
Number of competing MMsNever
Total request volume you’re not party toNever
These boundaries are enforced at the network protocol level. Your node does not receive this data — it is not a matter of field masking or access control. The data is physically not transmitted to your infrastructure.

What You Control

ComponentControlled By
Your backend instanceYou
Your databaseYou
Your JWT credentials (production)Your IdP
Your pricing logicYou
Network connectivity policiesYou