SettleMint
Developer guidesAPI integration

Tokenization API and digital asset platform API integration

Choose the right DALP tokenization API and digital asset platform API page for authentication, OpenAPI client generation, request headers, errors, webhooks, EVM token lifecycle workflows, token data, durable workflow recovery, smart wallets, and XvP settlement flows.

DALP tokenization API and digital asset platform API docs are grouped by the job you are doing and by documentation type. Developers use these pages to authenticate with the public API, generate clients from the OpenAPI contract, integrate configured EVM token lifecycle and asset data workflows, handle webhooks and events, and add production controls around errors, headers, monitoring, and recovery. The tokenization surfaces in these pages are EVM-only.

If you are new to DALP APIs, read Getting started first, then generate or configure a typed client from SDK integration. If you already know the integration surface, use the tables below to jump straight to the tokenization endpoint family, account abstraction surface, webhook guide, error model, or operational guide you need.

Public API paths

DALP exposes the current REST API under /api/v2 and serves its OpenAPI contract at /api/v2/spec.json. Use /api/v2 for new tokenization API and digital asset platform API integrations. Bare /api redirects to /api/v2. Use /api/v1 and /api/v1/spec.json only when you maintain an existing v1 client.

Token and asset operations use versioned paths such as POST /api/v2/tokens, PATCH /api/v2/tokens/{tokenAddress}/metadata, GET /api/v2/tokens/{tokenAddress}/events, and GET /api/v2/system/stats/portfolio-breakdowns. See API reference for the full route contract before adding request bodies, headers, or generated client code.

One-view route map

Rendering diagram...

The route map shows the usual reading order for tokenization API work. Authentication and client setup come first, the OpenAPI contract anchors implementation, and the domain pages narrow the endpoint family before you add production controls.

Start here

TypeIf you need toReadOutcome
How-toCreate an API key and make the first authenticated callGetting startedConfigure API key authentication and a generated TypeScript client.
How-toChoose SDK generation and client conventionsSDK integrationGenerate and organise a typed client around the OpenAPI contract.
ReferenceGenerate clients or inspect endpoint contractsAPI referenceUse the OpenAPI explorer and specification contract.
How-toDecide how API calls should behave in productionRequest headers and error handlingSet participant, wallet, idempotency, transaction-speed, and recovery behaviour before automation.

Pick the integration pattern

Choose the integration shape before you pick an endpoint. Most DALP tokenization API integrations combine a typed API client for commands, token and asset reads for reconciliation, event or webhook flows for downstream systems, and operational health checks for runbooks.

Treat this index as a route map, not as the endpoint contract. The endpoint pages and OpenAPI reference remain the source for request bodies, response shapes, and supported headers.

Integration jobBest starting pointUse this when
Backend service or customer application integrationSDK integration and API referenceYou need a typed client, API-key authentication, and a stable contract for application code.
Off-chain ledger, cap table, analytics, or audit syncOperational integration patternsYou need event replay, holder reconciliation, transaction-status checks, and idempotent reads.
Event-driven partner or provider workflowsWebhook endpointsYou need DALP to receive external provider callbacks or reconcile provider event delivery.
Production support and incident responseAPI monitoring and blockchain monitoringYou need health, readiness, indexer, RPC, finality, and snapshot-stream signals for operations.

Core integration model

TypeIf you need toReadOutcome
ReferenceConfigure shared headers for acting participants, execution wallets, idempotency, and transaction speedRequest headersSend headers only on routes that support them, with the right fallback behaviour.
ReferenceDiscover organisations, systems, networks, implementations, and contract factoriesSystem directory APIResolve the platform directory data needed before calling scoped API surfaces.
ConceptScope integrations across organisations and systemsOrganisation and system scopeKeep API keys, organisations, systems, and permission boundaries aligned.
ConceptReuse operational patterns across API integrationsOperational integration patternsPlan retries, idempotency, transaction tracking, and production handoffs.

Tokenization API surfaces

TypeIf you need toReadOutcome
ReferenceManage token lifecycle operationsToken lifecycleCreate assets, change supply, manage holders, documents, metadata, permits, and decimals.
ReferenceUpdate mutable token metadataToken metadataSet or remove issuer-defined metadata fields and inspect metadata update behaviour.
ReferenceRegister deployed EVM tokensExternal tokensRegister and list already deployed EVM tokens inside DALP.
ReferenceAttach and retrieve token documentsToken documentsManage document links and metadata for asset records.
ReferenceWork with token holders and transfersToken holders and transfersInspect holder balances and transfer-related API surfaces.
ReferenceRead indexed token eventsToken eventsQuery token activity, wallet-scoped event history, facets, pagination, and dapp table behaviour.
ReferenceResolve asset pricing and statisticsToken price resolution, Exchange rates, Token volume statistics, Yield coverage statistics, Portfolio statistics, and Asset decimalsRead pricing, FX rates, volume, yield, portfolio, and decimal precision surfaces.
ReferenceIntegrate XvP settlement flowsXvP settlement flowsIntegrate hold, release, settlement, and cancellation workflows for XvP settlement.

Wallets/account abstraction

TypeIf you need toReadOutcome
ConceptDiscover smart accounts and approvalsSmart wallets, Smart wallet approvals, and Smart wallet thresholdsDiscover wallets, review approval requirements, and inspect threshold settings.
ReferenceRecover wallet identity linksIdentity recoveryInspect identity recovery surfaces for smart-account integrations.
ReferenceRead native account balancesAccount native balancesRead native asset balances for accounts.
ReferenceDiscover account abstraction network supportAccount abstraction transaction relayDiscover the active chain and ERC-4337 EntryPoint support.
ReferenceOperate sponsored gas settingsGas sponsorship paymastersInspect paymaster balances, deposits, sponsorship configuration, and signer keys.

Compliance APIs

TypeIf you need toReadOutcome
ReferenceReuse compliance templatesCompliance templatesApply reusable compliance rules to asset and transfer workflows.
ReferenceConfigure module-backed transfer controlsCompliance modulesConfigure compliance modules that enforce transfer controls.
ReferenceWork with address-book contactsAddress book contactsReview contact data that supports allowlist and counterparty workflows.
How-toUpload KYC documentsKYC document uploadsSend KYC evidence files through DAPI so DALP can validate, encrypt, store, list, and download them on a KYC version.

Reporting, monitoring, and recovery

TypeIf you need toReadOutcome
ConceptMonitor API operationsAPI monitoringTrack health, latency, and operational signals around API integrations.
ReferenceMap reporting and audit evidence surfacesReporting and audit accessChoose holder, event, action, export, webhook, and transaction evidence for reporting.
ReferencePlan operator recovery for blocked durable workflow stateworkflow engine recoveryCheck when recovery actions are appropriate before changing workflow state.
ReferenceCall workflow engine operator routesworkflow engine operator APIInspect route bodies, success payloads, component statuses, and retry-blocked behaviour.

Webhooks/integrations

TypeIf you need toReadOutcome
ReferenceReceive platform eventsEvents catalogueConfigure webhook destinations, then use the event reference for lifecycle states and payload schemas.

Error/API reference

TypeIf you need toReadOutcome
How-toHandle API and OpenAPI errorsError handlingDistinguish request validation, platform errors, and error-code recovery paths.
ReferenceLook up API error identifiersAPI error referenceMatch returned API error identifiers to status, retry behaviour, and recovery.
ReferenceLook up smart contract error codesSmart contract error referenceDecode contract revert codes returned through API error responses.

Example reading paths

ScenarioRead in this orderWhy this path works
First API integrationGetting started, SDK integration, API referenceYou authenticate first, generate a client, then confirm request and response shapes against the contract.
KYC evidence uploadRequest headers, KYC document uploads, error handlingYou set acting context before the upload, then handle validation, storage, listing, download, and retry behaviour.
Production reconciliationOperational integration patterns, Token events, Reporting and audit access, API monitoringYou pair reads and event history with audit evidence and health signals before automation depends on them.
XvP settlement integrationXvP settlement flows, Request headers, error handling, blockchain monitoringYou implement the settlement workflow, then add participant context, recovery rules, and chain operational checks.

Keep the navigation narrow

Use this index for routing. Endpoint reference pages, generated OpenAPI pages, and workflow guides remain the source for implementation details.

For mutation pages, check request headers, error handling, and idempotency first. Review monitoring and recovery notes before production automation.

On this page