Application Kits/Asset Tokenization

API Portal

Complete API reference for tokenization platforms. REST & GraphQL APIs for bonds, stablecoins, equity tokens. 150+ endpoints with enterprise-grade security and 99.9% uptime.

What is the Asset Tokenization API Portal?

For developers integrating tokenization into existing systems: The API Portal provides comprehensive programmatic access to all tokenization features through REST and GraphQL interfaces. This enables seamless integration of digital assets into banking systems, trading platforms, and enterprise applications without touching blockchain code directly.

Who uses the Tokenization APIs?

Primary Users

  • System Integrators connecting tokenization to core banking systems
  • FinTech Developers building digital asset applications
  • Trading Platforms adding tokenized asset support
  • Enterprise IT Teams automating treasury operations
  • Third-party Vendors creating value-added services

Problems Solved

  • Integration Complexity: Pre-built connectors for major platforms
  • Blockchain Abstraction: No Web3 knowledge required
  • Performance: Sub-100ms response times at scale
  • Security: Enterprise-grade authentication and encryption
  • Compliance: Built-in regulatory controls in every endpoint

How to get started with APIs?

Step 1: Generate API Key

Create API Key

Navigate to API Keys tab in the portal

Click "Create API Key" button

Name your key (e.g., "Production API", "Mobile App", "Integration Layer")

Set optional expiry date for temporary access

Copy and securely store the generated key

Security Best Practices:

  • Never expose keys in frontend code
  • Use environment variables for storage
  • Rotate keys quarterly
  • Set expiry dates for temporary access
  • Use separate keys per environment

Step 2: Authentication

All API requests require authentication via header:

x-api-key: YOUR_GENERATED_KEY_HERE

Example Request:

curl -X GET https://api.settlemint.com/api/bond \
  -H "x-api-key: sm_prod_a1b2c3d4e5f6g7h8i9j0" \
  -H "Content-Type: application/json"

Step 3: Access Documentation

API Portal

The interactive Swagger documentation provides:

  • Live API Testing: Try endpoints with real data
  • Code Generation: Export client libraries in 10+ languages
  • Request Examples: Copy-paste ready samples
  • Response Schemas: Detailed field descriptions
  • Error Codes: Comprehensive troubleshooting guide

API Response

What APIs are available?

Bond Management APIs

For tokenizing debt instruments and managing their lifecycle:

MethodEndpointPurposeUse Case
GET/api/bondList all bondsDisplay bond marketplace
GET/api/bond/{address}Get bond detailsShow bond information page
POST/api/bond/factoryDeploy new bondIssue corporate/government bonds
POST/api/bond/mintIssue bond tokensPrimary market issuance
POST/api/bond/transferTransfer ownershipSecondary market trading
POST/api/bond/matureMark as maturedTrigger redemption period
POST/api/bond/redeemRedeem for principalInvestor cash-out
PATCH/api/bond/set-yield-scheduleConfigure interestSet coupon payments

Real-world example:

// Issue a $10M corporate bond
const response = await fetch('/api/bond/factory', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: "Apple Inc 2025 Bond",
    symbol: "AAPL25",
    faceValue: 1000,
    totalSupply: 10000,
    couponRate: 5.5,
    maturityDate: "2025-12-31"
  })
});

Stablecoin Operations APIs

For managing fiat-backed digital currencies:

MethodEndpointPurposeUse Case
GET/api/stablecoinList stablecoinsShow available currencies
POST/api/stablecoin/factoryDeploy stablecoinLaunch USDC, EURC
POST/api/stablecoin/mintCreate new supplyIssue against reserves
POST/api/stablecoin/burnReduce supplyRedeem for fiat
POST/api/stablecoin/transferSend paymentP2P transactions
PUT/api/stablecoin/freezeFreeze accountCompliance action
PATCH/api/stablecoin/update-collateralUpdate reservesProof of reserves

Integration example:

// Process cross-border payment
const payment = await fetch('/api/stablecoin/transfer', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    token: "0x123...",
    from: "0xABC...",
    to: "0xDEF...",
    amount: "1000000", // $1,000 USDC
    memo: "Invoice #12345"
  })
});

Equity Token APIs

For digital share management:

MethodEndpointPurposeUse Case
GET/api/equityList equity tokensShow cap table
POST/api/equity/factoryCreate equity tokenIssue shares
POST/api/equity/mintIssue new sharesFunding rounds
POST/api/equity/transferTransfer sharesSecondary sales
DELETE/api/equity/burnCancel sharesBuybacks
PUT/api/equity/block-userRestrict holderCompliance

Cap table automation:

// Issue Series A shares
const seriesA = await fetch('/api/equity/factory', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: "Startup Inc Series A Preferred",
    symbol: "STRT-A",
    totalShares: 1000000,
    pricePerShare: 10,
    liquidationPreference: 1.5,
    votingRights: true
  })
});

Fund Token APIs

For tokenized investment vehicles:

MethodEndpointPurposeUse Case
GET/api/fundList fundsFund marketplace
POST/api/fund/factoryCreate fundLaunch new fund
POST/api/fund/mintIssue fund tokensInvestor subscription
POST/api/fund/withdrawRedeem tokensInvestor exit
PATCH/api/fund/update-navUpdate NAVDaily pricing

Cryptocurrency APIs

For utility and governance tokens:

MethodEndpointPurposeUse Case
GET/api/cryptocurrencyList tokensToken directory
POST/api/cryptocurrency/factoryDeploy tokenLaunch utility token
POST/api/cryptocurrency/mintCreate supplyRewards distribution
POST/api/cryptocurrency/withdrawClaim tokensUser withdrawals

Supporting APIs

User & Identity Management

// KYC verification check
GET /api/user/wallet/{address}
// Returns user KYC status, tier, limits

// Bulk user import
POST /api/user/bulk-import
// Import existing customer base

Transaction Monitoring

// Get transaction history
GET /api/transaction/address/{address}
// Returns paginated transaction list

// Real-time transaction feed
GET /api/transaction/timeline
// WebSocket for live updates

Analytics & Reporting

// Asset statistics
GET /api/asset-stats/{address}
// Returns supply, holders, volume

// Portfolio valuation
GET /api/asset-balance/portfolio/{wallet}
// Returns all token holdings

Market Data Integration

// Get exchange rates
GET /api/providers/exchange-rates/USD
// Returns current FX rates

// Update asset price
PATCH /api/providers/asset-price/{assetId}
// Oracle price updates

How to integrate with existing systems?

Banking System Integration

Core Banking Connection:

// Temenos T24 Integration Example
class T24TokenizationBridge {
  async createDigitalAsset(accountData) {
    // Map T24 account to token
    const token = await tokenizationAPI.createBond({
      issuer: accountData.customerId,
      amount: accountData.balance,
      currency: accountData.currency,
      maturity: accountData.maturityDate
    });
    
    // Update T24 with token reference
    await t24API.updateAccount({
      accountId: accountData.id,
      tokenAddress: token.address,
      tokenStatus: 'ACTIVE'
    });
  }
}

ERP Integration

SAP Integration Pattern:

// SAP Treasury Integration
const sapTreasuryConnector = {
  async syncBondIssuance(bondData) {
    // Create bond on blockchain
    const bond = await api.bond.factory(bondData);
    
    // Update SAP with blockchain reference
    await sap.createFinancialInstrument({
      type: 'BOND',
      blockchainId: bond.address,
      amount: bondData.totalSupply * bondData.faceValue
    });
  }
};

Trading Platform Integration

Exchange Integration:

// Add tokenized assets to order book
class TokenizedAssetExchange {
  async addListingSupport(tokenAddress) {
    const token = await api.getTokenDetails(tokenAddress);
    
    return exchange.addTradingPair({
      base: token.symbol,
      quote: 'USD',
      contract: tokenAddress,
      decimals: token.decimals,
      minOrder: 0.01
    });
  }
}

What are the performance specifications?

API Performance Metrics

  • Response Time: <100ms average, <500ms 99th percentile
  • Throughput: 10,000 requests/second per instance
  • Availability: 99.9% uptime SLA
  • Global Coverage: CDN endpoints in 15 regions

Rate Limits

  • Standard Tier: 1,000 requests/minute
  • Professional: 10,000 requests/minute
  • Enterprise: Unlimited with dedicated infrastructure

Batch Operations

// Batch mint tokens for 1000 investors
POST /api/bond/batch-mint
{
  "operations": [
    {"to": "0x123...", "amount": "1000"},
    {"to": "0x456...", "amount": "2000"},
    // ... up to 1000 operations
  ]
}

How secure are the APIs?

Security Features

  • Encryption: TLS 1.3 for all connections
  • Authentication: API key + optional OAuth2
  • Authorization: Role-based access control
  • Audit Trail: Complete request logging
  • DDoS Protection: Cloudflare enterprise

Compliance Controls

  • IP Whitelisting: Restrict access by location
  • Transaction Limits: Configurable per API key
  • Suspicious Activity Detection: ML-based monitoring
  • Regulatory Reporting: Automated compliance exports

What SDK support is available?

Official SDKs

npm install @settlemint/tokenization-sdk
pip install settlemint-tokenization
<dependency>
  <groupId>com.settlemint</groupId>
  <artifactId>tokenization-sdk</artifactId>
</dependency>
go get github.com/settlemint/tokenization-go

SDK Example Usage

import { TokenizationClient } from '@settlemint/tokenization-sdk';

const client = new TokenizationClient({
  apiKey: process.env.SETTLEMINT_API_KEY,
  network: 'mainnet'
});

// Issue a bond
const bond = await client.bonds.create({
  name: 'Corporate Bond 2024',
  symbol: 'CB24',
  faceValue: 1000,
  supply: 10000,
  couponRate: 5.5
});

// Monitor events
client.events.on('Transfer', (event) => {
  console.log(`Bond transferred: ${event.from} -> ${event.to}`);
});

Frequently asked questions

API quick reference

Most Used Endpoints

Asset Creation

  • POST /api/{asset-type}/factory - Deploy new assets
  • POST /api/{asset-type}/mint - Issue tokens
  • POST /api/{asset-type}/transfer - Transfer ownership

Asset Management

  • GET /api/{asset-type} - List assets
  • GET /api/{asset-type}/{address} - Get details
  • PATCH /api/{asset-type}/{address} - Update parameters

Compliance & Control

  • PUT /api/{asset-type}/access-control/grant-role - Permissions
  • PUT /api/{asset-type}/block-user - Restrictions
  • GET /api/transaction/address/{address} - Audit trail

Analytics & Reporting

  • GET /api/asset-stats/{address} - Asset metrics
  • GET /api/asset-balance/portfolio/{wallet} - Holdings
  • GET /api/transaction/timeline - Activity feed

Next steps

Ready to integrate tokenization APIs?