List your asset on Assetera
A worked B2B example. An issuer brings one instrument and reaches every partner tenant entitled to carry it, without a separate integration for each distributor.
You bring one instrument. It reaches every partner tenant entitled to carry it. You do not integrate with each distributor, and you do not build a customer journey, a compliance operation, or a settlement path.
This is the other direction of the same network described in Embed the marketplace in your app. There, a partner brings customers. Here, an institution brings an asset, and the two meet in one catalog.
At a glance
| Who does it | |
|---|---|
| The instrument, its documents and its terms | you |
| The price and the per-purchase limits | you, as contract state you control |
| How the instrument settles | you, agreed with Assetera at onboarding. Distributors consume it |
| Deciding who may buy | Assetera, on every purchase |
| The distribution reach | Assetera's partner tenants, per the entitlements you agree |
| Taking the money and delivering the tokens | the settlement rail, on chain or by bank transfer |
| The audit trail and the reporting | Assetera |
The journey
- 1You supply the onboarding pack · Your firmIssuer, instrument, documents, token and network details.
- 2Assetera configures and reviews the listing · AsseteraIt activates only after the required approvals.
- 3Entitlement decides who may carry it · AsseteraPer partner tenant, so two distributors can see different catalogs.
- 4You set the price and the caps · Your firmOn the own-issuance rail these are contract state you hold the role for.
- 5Partner apps show it to their customers · Your firmOne listing, many front ends, no per-distributor build.
- 6Each buyer is screened and checked · AsseteraEligibility, appropriateness, limits, trading window.
- 7The purchase settles and is measured · ChainAmounts come from balance deltas, not from a reported figure.
- 8You reconcile · Your firmIn the issuer portal for the bank-transfer rail.
The three ways a sale settles, and you choose which
This is your decision, not a distributor's. You agree the settlement method with Assetera when the instrument is onboarded, and it becomes a property of that instrument. Every partner distributing it consumes that choice: they read the catalog and implement the flow it names. A buyer cannot pick a rail at request time, and neither can a distributor.
Choosing well is therefore a distribution decision as much as an operational one. A rail that few partners have implemented reaches fewer of their customers, so it is worth asking your Assetera contact which rails the partners you care about already support.
| Rail | The buyer pays with | What happens | Read |
|---|---|---|---|
| Bank transfer | a bank transfer against a reference | Assetera reconciles the payment, then the tokens are delivered | Off-chain sale |
| Your own issuance | a settlement currency on chain | your issuance venue mints against the price you set, in one transaction | Primary issuance |
| A third-party venue | a settlement currency on chain | the router buys from an external venue and delivers atomically | Primary settlement |
On the on-chain rails a purchase is one transaction. An ERC-2612 permit and the settlement travel together, so a buyer does not send a separate approval first and does not need to hold gas.
What the price and the caps really are
On the own-issuance rail, one contract is deployed per offering. It holds the unit price and the minting right, so the terms of your offering are on chain and are not an instruction someone sends with a purchase.
| Where it lives | |
|---|---|
| Unit price | contract state, changed only by the role holder, inside deploy-time bounds |
| Per-purchase cap | contract state. A cap of zero means closed, not unlimited |
| Minting right | granted by you to the venue. Ungranted, the first purchase fails |
| Delivery amount | measured from the balance change, never from a reported number |
See Issuance venue for the contract itself and Contracts and addresses for the deployed routers. If your token issues through a call of its own, such as one that requires the investor to be whitelisted first, your developers extend that contract rather than replace it: Extend the issuance venue.
A primary purchase moves no chart
Market data comes from secondary fills. A primary purchase has no maker, no taker and no side, so inventing one would corrupt the market data. An instrument can sell steadily and show a flat chart, which is correct rather than a gap. Do not build a "sold so far" figure out of chart data.
Onboarding the listing
You send the onboarding pack, Assetera configures the listing, reviews it and activates it. The rail, the currency, the window and the channels are part of the pack.
Entitlement is explicit
A listing does not appear in every partner catalog by default. Instruments are assigned to tenants, which is what lets two distributors be offered different subsets of the same assets. Agree the entitlements you want as part of the distribution terms.
After it is live
Issuer-facing reporting beyond reconciliation
The issuer portal covers receiving accounts and bank-transfer reconciliation today. Reporting for the on-chain rails is coordinated with Assetera rather than self-service, and the self-service surface for it is not documented here yet.
For an integration that needs the purchase data programmatically, the on-chain event is the record: every amount on it is a measured balance delta. See Contract events.
Next
Embed the marketplace in your app
The other direction: bring customers instead of an asset.
The onboarding pack
The five items an instrument needs before it is configured.
Primary issuance
How your own issuance prices, mints and delivers in one transaction.
Primary sale API
The endpoints a distributor calls to quote and settle a purchase.
Bring your asset to Assetera
List a tokenized security once and reach every channel Assetera serves. What you bring, what you decide, what Assetera runs, and what to have ready for the first call.
List an existing token
A worked example for a token that already exists: listed for secondary trading on Assetera's venue and carried by every channel, with no primary sale and no contract work.