ITN Integration

Alpaca’s Instant Tokenization Network (ITN) allows authorized participants to convert supported underlying securities into Ondo Stocks and redeem Ondo Stocks for the underlying securities. For the complete ITN workflow and API details, see Alpaca’s Tokenization Guide for Authorized Participants.

Choose an environment

Production
Staging

Production connects Ondo’s production environment with Alpaca’s live environment.

Service	Base URL
Ondo Global Markets	`https://api.gm.ondo.finance`
Alpaca Broker API	`https://broker-api.alpaca.markets`

Production ITN transactions involve assets with real value. On-chain transactions are irreversible and require ETH or BNB for gas.

Staging connects Ondo’s staging environment with Alpaca’s sandbox.

Service	Base URL
Ondo Global Markets	`https://api.gm-staging.ondo.finance`
Alpaca Broker API	`https://broker-api.sandbox.alpaca.markets`

Staging contracts are deployed on Ethereum and BNB Chain mainnet. Tokens minted through the sandbox flow have no monetary value, but on-chain transactions require real ETH or BNB for gas.

Prerequisites

Complete these steps before submitting an ITN request:

When signing up for an Alpaca account and an Ondo account, you must use the same email address. The handshake process will fail to complete if there is a mismatch.

Complete onboarding with Alpaca for a BrokerAPI account. Contact Ondo for an introduction to the Alpaca team, or coordinate directly with Alpaca if you already have a relationship. A TradingAPI account alone does not currently meet ITN onboarding requirements. Use an Alpaca sandbox account for staging and a live Alpaca account for production.
Complete the Ondo Stocks onboarding and KYC process to establish your Ondo account. Use the same email address as your Alpaca account.
Request access to the Ondo API and obtain an API key for your selected environment.
Confirm that your Alpaca and Ondo accounts use the same email address before requesting the handshake. Provide the Alpaca team with this shared email address and your corresponding Alpaca account number. The account number is different from the Alpaca account ID used in API paths.
Wait for Alpaca to coordinate with Ondo regarding the linking of your accounts.
Provide the Ondo team with the wallet address that you plan to use for ITN requests.
Wait for Ondo to enable ITN access for the wallet(s) you provided.

Mint requests will fail if the Alpaca and Ondo accounts are not linked or if the destination wallet has not been enabled for ITN.

Supported assets

ITN supports the assets below on Ethereum and BNB Chain. Use the underlying symbol, without the on suffix, when submitting an Alpaca request.

Production
Staging

Ondo Stock	Underlying symbol
`AAPLon`	`AAPL`
`AMDon`	`AMD`
`AMZNon`	`AMZN`
`ARMon`	`ARM`
`AVGOon`	`AVGO`
`COINon`	`COIN`
`CRCLon`	`CRCL`
`DRAMon`	`DRAM`
`GLWon`	`GLW`
`GOOGLon`	`GOOGL`
`INTCon`	`INTC`
`METAon`	`META`
`MRVLon`	`MRVL`
`MSFTon`	`MSFT`
`MSTRon`	`MSTR`
`MUon`	`MU`
`NVDAon`	`NVDA`
`ORCLon`	`ORCL`
`QQQon`	`QQQ`
`SKHYon`	`SKHY`
`SNDKon`	`SNDK`
`SPCXon`	`SPCX`
`SPYon`	`SPY`
`STRCon`	`STRC`
`TQQQon`	`TQQQ`
`TSLAon`	`TSLA`
`TSMon`	`TSM`

Ondo Stock	Underlying symbol
`AAPLon`	`AAPL`
`AMZNon`	`AMZN`
`MSFTon`	`MSFT`
`NVDAon`	`NVDA`
`TSLAon`	`TSLA`

Rate limits

The following USD notional limits apply independently to mint and redemption requests during each market session. Each request must meet the minimum per request, and the combined value of your requests must not exceed the maximum total per account for that session.

Production
Staging

Market session	Minimum per request	Maximum total per account
Pre-market	$1,000	$250,000
Regular	$1,000	$1,000,000
Post-market	$1,000	$250,000
Overnight	$1,000	$250,000
Off-hours	$1,000	$250,000

Market session	Minimum per request	Maximum total per account
Pre-market	$1	$500,000
Regular	$1	$1,000,000
Post-market	$1	$500,000
Overnight	$1	$250,000
Off-hours	$1	$100,000

Additional system-wide and asset-level limits apply. During periods of high traffic, these limits may prevent a mint from being accepted or delay a redemption until capacity becomes available.

Fees

Production
Staging

Ondo currently charges no fees for minting or redeeming Ondo Stocks through ITN.

Ondo processes in-kind transfers between the underlying securities and Ondo Stocks at no additional cost.

Alpaca may charge its own fees for mint and redemption requests. The response from Alpaca’s List Tokenization Requests endpoint includes any fees associated with each request. See Alpaca’s Tokenization Guide for Authorized Participants for its current fee schedule.

Check asset availability

Before minting or redeeming, use Get Current Market Status and Get Asset Statuses to check for market-wide and asset-specific pauses. All Ondo API requests require an API key in the x-api-key header.

Production
Staging

curl --request GET \
  "https://api.gm.ondo.finance/v1/status/market" \
  --header "x-api-key: ${GM_API_KEY}"

curl --request GET \
  "https://api.gm.ondo.finance/v1/status/assets" \
  --header "x-api-key: ${GM_API_KEY}"

curl --request GET \
  "https://api.gm-staging.ondo.finance/v1/status/market" \
  --header "x-api-key: ${GM_API_KEY}"

curl --request GET \
  "https://api.gm-staging.ondo.finance/v1/status/assets" \
  --header "x-api-key: ${GM_API_KEY}"

Ondo does not continue redemption settlement while a relevant MARKET_PAUSED or ASSET_PAUSED status is active. ASSET_LIMITED does not pause ITN. These endpoints do not expose every ITN-specific or chain-specific pause. If no active pause is reported and a request remains pending, contact support@ondo.finance.

Mint Ondo Stocks

To mint Ondo Stocks, submit a request through Alpaca’s Mint Request endpoint. Set issuer to ondo. The only supported network values are ethereum for Ethereum and binance for BNB Chain.

Production
Staging

curl --request POST \
  "https://broker-api.alpaca.markets/v1/accounts/${ALPACA_ACCOUNT_ID}/tokenization/mint" \
  --user "${ALPACA_BROKER_KEY}:${ALPACA_BROKER_SECRET}" \
  --header "Content-Type: application/json" \
  --data '{
    "underlying_symbol": "AAPL",
    "qty": "1",
    "issuer": "ondo",
    "network": "ethereum",
    "wallet_address": "0xYOUR_ENABLED_WALLET"
  }'

Use your live Alpaca credentials for production ITN requests.

curl --request POST \
  "https://broker-api.sandbox.alpaca.markets/v1/accounts/${ALPACA_ACCOUNT_ID}/tokenization/mint" \
  --user "${ALPACA_BROKER_KEY}:${ALPACA_BROKER_SECRET}" \
  --header "Content-Type: application/json" \
  --data '{
    "underlying_symbol": "AAPL",
    "qty": "1",
    "issuer": "ondo",
    "network": "ethereum",
    "wallet_address": "0xYOUR_ENABLED_WALLET"
  }'

Use your Alpaca sandbox credentials for staging ITN requests.

The qty field is the number of underlying shares to tokenize and may contain up to nine decimal places. Ondo calculates the corresponding Ondo Stock token amount and delivers it to the enabled wallet after the underlying shares settle. To mint on BNB Chain, change network to binance.

Check request status

Use Alpaca’s List Tokenization Requests endpoint to monitor your mint and redemption requests:

Production
Staging

curl \
  "https://broker-api.alpaca.markets/v1/accounts/${ALPACA_ACCOUNT_ID}/tokenization/requests" \
  --user "${ALPACA_BROKER_KEY}:${ALPACA_BROKER_SECRET}"

curl \
  "https://broker-api.sandbox.alpaca.markets/v1/accounts/${ALPACA_ACCOUNT_ID}/tokenization/requests" \
  --user "${ALPACA_BROKER_KEY}:${ALPACA_BROKER_SECRET}"

Each request has a status of pending, completed, or rejected. The response also includes identifiers, quantities, network information, transaction hashes, and any fees associated with the requests.

Redeem Ondo Stocks

Redemptions begin on-chain. From the wallet enabled during onboarding, first approve the ITN issuer contract to spend the Ondo Stocks you want to redeem. Then call redeem(address,uint256) on the issuer contract. A successful redemption burns the tokens. Ondo detects the burn and works with Alpaca to transfer the corresponding underlying shares to your linked Alpaca account. See Alpaca’s Redeem Workflow for more information.

Find the token contract address

Use Get Contract Addresses for an Asset with the Ondo Stock symbol:

Production
Staging

curl --request GET \
  "https://api.gm.ondo.finance/v1/assets/${TOKEN_SYMBOL}/addresses" \
  --header "x-api-key: ${GM_API_KEY}"

curl --request GET \
  "https://api.gm-staging.ondo.finance/v1/assets/${TOKEN_SYMBOL}/addresses" \
  --header "x-api-key: ${GM_API_KEY}"

Select the address whose networkChainId is ethereum-1 or bsc-56. Use the returned decimals value when converting a human-readable token amount into the integer passed to the contract.

Submit the redemption

The flow is the same on Ethereum and BNB Chain. Use an RPC endpoint for your selected network and the corresponding ITN issuer contract:

Production
Staging

Network	ITN issuer contract
Ethereum	`0xec8bBB0c90c0B5F4D8240D0F7b49DA3b0aA41f4E`
BNB Chain	`0x341f9e6463161f0c90037cbc0150dc54e6d1e06e`

Network	ITN issuer contract
Ethereum	`0x46c65333cea9a3c6357c4f075e9f67aaef0639df`
BNB Chain	`0x194e4db0a165c4108db08534564196d915eadcf3`

These contracts are deployed on mainnet even though staging uses Alpaca’s sandbox. The tokens have no monetary value, but transactions require real ETH or BNB for gas.

The approval and redemption transactions must both be sent from the wallet that Ondo enabled for ITN. The example below uses Foundry’s cast command. Ondo Stocks use 18 decimal places, so convert the human-readable token amount before submitting it. This amount represents the Ondo Stocks being redeemed, not the number of underlying shares.

TOKEN_ADDRESS="0xTOKEN_ADDRESS"
ISSUER_ADDRESS="0xITN_ISSUER_ADDRESS"
TOKEN_AMOUNT="1.5"
AMOUNT_WEI="$(cast to-wei "${TOKEN_AMOUNT}")"
RPC_URL="https://YOUR_NETWORK_RPC_URL"

# Approve the ITN issuer contract to spend the tokens being redeemed.
cast send "${TOKEN_ADDRESS}" \
  "approve(address,uint256)" "${ISSUER_ADDRESS}" "${AMOUNT_WEI}" \
  --rpc-url "${RPC_URL}" \
  --private-key "${PRIVATE_KEY}"

# Transfer and burn the tokens to begin settlement through Alpaca.
cast send "${ISSUER_ADDRESS}" \
  "redeem(address,uint256)" "${TOKEN_ADDRESS}" "${AMOUNT_WEI}" \
  --rpc-url "${RPC_URL}" \
  --private-key "${PRIVATE_KEY}"

After the redemption transaction is confirmed, use the request status endpoint to follow settlement. It may take time for a newly observed redemption to appear in Alpaca. Do not resubmit a successful on-chain redemption while it is being processed. The request remains pending until Alpaca transfers the underlying shares and the redemption completes.

Home

REST API

Streaming API

References

Choose an environment

Prerequisites

Supported assets

Rate limits

Fees

Check asset availability

Mint Ondo Stocks

Check request status

Redeem Ondo Stocks

Find the token contract address

Submit the redemption

​Choose an environment

​Prerequisites

​Supported assets

​Rate limits

​Fees

​Check asset availability

​Mint Ondo Stocks

​Check request status

​Redeem Ondo Stocks

​Find the token contract address

​Submit the redemption

Choose an environment

Prerequisites

Supported assets

Rate limits

Fees

Check asset availability

Mint Ondo Stocks

Check request status

Redeem Ondo Stocks

Find the token contract address

Submit the redemption