Mint a Tokenized Asset

post

https://broker-api.sandbox.alpaca.markets/v1/accounts/{account_id}/tokenization/mint

This endpoint is used by an Authorized Participant to request the minting of a tokenized asset. Alpaca will initiate a journal of the underlying asset from the Authorized Participant's account to the issuer's account.

Idempotency: When the Idempotency-Key header is supplied, this endpoint is
idempotent. Multiple requests with the same key and identical request body will
create only one mint request. A subsequent request returns the previously created
request with the same response (no duplicate is created). If the same key is used
with a different request body, the API returns 422 Unprocessable Entity.

Recommended for production: Always supply Idempotency-Key when requesting a
mint. This allows safe retries on timeouts, network errors, or 5xx responses
without risking duplicate requests. Use a client-generated unique value (e.g. UUID).

Path Params

account_id

uuid

required

Account identifier.

Body Params

client_request_id

string

length ≤ 128

Optional label of your choosing for this mint request. It is returned on the mint response and on the tokenization request, and you can retrieve the request by it with the Get Tokenization Request by client_request_id endpoint. If multiple requests within the same account share the same client_request_id, the endpoint returns the most recent matching request. To prevent duplicate processing, use the Idempotency-Key header.

Must be at most 128 printable ASCII characters with no leading or trailing whitespace.

issuer

string

enum

required

The tokenized asset's issuer

Allowed:

network

string

enum

required

The token's blockchain network

qty

string

required

The underlying quantity to convert into the tokenized asset. It can be fractional.

underlying_symbol

string

required

The underlying asset symbol

wallet_address

string

required

The wallet address to receive the tokenized asset

Headers

Idempotency-Key

string

length ≤ 128

Optional client-generated key for safe retries and duplicate request detection.
This endpoint currently accepts keys up to 128 characters. Alpaca is moving toward
a 36-character maximum; new implementations should generate a unique UUIDv7 or
UUIDv4 value (36 characters including hyphens) for each logical operation. Do not
reuse a key across operations.

Responses

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successfully requested minting of a tokenized asset.

400Bad request (e.g. malformed input, insufficient position, or account not authorized to mint). Also returned when the Idempotency-Key header is malformed, or when replaying a request that was originally rejected.

401Authentication credentials are missing or invalid.

403Caller is not authorized to perform this operation.

422One or more request parameters are missing or invalid, or the same Idempotency-Key was reused with a different request body.