Quickstart

Step 1: Onboard to Ondo Stocks & Intelligent Portfolios

To get started, reach out to onboarding@ondo.finance and let the team know you’re interested in API access. Then head to app.ondo.finance to begin the onboarding process. The Ondo team will follow up with instructions to get your API keys.

Step 2: Get Your First Price Quote

Once you have your API key, try fetching the current price for TSLAon:

curl -X GET "https://api.gm.ondo.finance/v1/assets/prices/TSLAon" \
  -H "x-api-key: YOUR_API_KEY"

All requests are authenticated via the x-api-key header.

Step 3: Request a Soft Quote

A soft quote provides a non-binding price estimate without impacting your trading limits — useful for displaying pricing in a UI or validating quotes before committing:

curl -X POST "https://api.gm.ondo.finance/v1/attestations/soft" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "TSLAon",
    "side": "buy",
    "notionalValue": "1000",
    "duration": "short"
  }'

Step 4: Request a Mint Attestation

When you’re ready to execute, request a binding mint attestation. This creates a signed payload that authorizes an on-chain mint:

curl -X POST "https://api.gm.ondo.finance/v1/attestations" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "TSLAon",
    "side": "buy",
    "notionalValue": "1000",
    "duration": "short"
  }'

The response includes key fields such as attestationId, signature, and expiration that you’ll need for the on-chain transaction.

Step 5: Submit On-Chain

Take the attestation signature from the response and submit it to the smart contract manager for the asset type, along with USDC or another supported stablecoin, to atomically mint your tokens. See the smart contract reference for Ondo Stocks & Intelligent Portfolios contract instructions and addresses.

Next Steps

Error Codes — Reference for all API error codes
API Caching Strategy — Caching durations for each endpoint
Smart contract reference — Contract interface for minting and redeeming
Smart contract addresses — Contract addresses across supported chains

Home

REST API

Streaming API

References

Step 1: Onboard to Ondo Stocks & Intelligent Portfolios

Step 2: Get Your First Price Quote

Step 3: Request a Soft Quote

Step 4: Request a Mint Attestation

Step 5: Submit On-Chain

Next Steps

​Step 1: Onboard to Ondo Stocks & Intelligent Portfolios

​Step 2: Get Your First Price Quote

​Step 3: Request a Soft Quote

​Step 4: Request a Mint Attestation

​Step 5: Submit On-Chain

​Next Steps

Step 1: Onboard to Ondo Stocks & Intelligent Portfolios

Step 2: Get Your First Price Quote

Step 3: Request a Soft Quote

Step 4: Request a Mint Attestation

Step 5: Submit On-Chain

Next Steps