Sample Responses

These examples are representative. Use the live OpenAPI snapshot for exact schema names and the API response for production values.

Unified Envelope

{
  "code": 200,
  "errMsg": "",
  "data": {},
  "uuid": "b3d8d0b5-2f93-4f4e-bf06-2f0e5a9f6d1f",
  "t": 1782390000000
}

Symbols

{
  "code": 200,
  "errMsg": "",
  "data": [
    {
      "symbol": "AAPL",
      "contractAddress": "0x3333333333333333333333333333333333333333",
      "contractSymbol": "aAAPL",
      "contractName": "Synfutures Apple Inc.",
      "decimals": 18,
      "onChainDecimals": 18,
      "tradable": true,
      "fractionable": true,
      "overnightTradable": false,
      "fractionalEhEnabled": false,
      "price": 180.5,
      "change24H": 1.2,
      "change24HPercent": 0.67,
      "logoUrl": "https://example.com/aapl.png",
      "lastUpdateTimestamp": 1782390000,
      "name": "Apple Inc.",
      "pdfUrl": "https://example.com/aapl.pdf",
      "volume24H": 1234567
    }
  ],
  "uuid": null,
  "t": null
}

Portfolio Balance

{
  "code": 200,
  "errMsg": "",
  "data": {
    "chainId": 143,
    "productType": "Synfutures",
    "address": "0x1111111111111111111111111111111111111111",
    "mUsdBalance": "100.00",
    "tokenBalances": [
      {
        "address": "0x2222222222222222222222222222222222222222",
        "name": "USD Coin",
        "symbol": "USDC",
        "stockSymbol": null,
        "isStock": false,
        "decimals": 6,
        "price": null,
        "walletBalance": "250.00",
        "walletAllowance": "1000.00",
        "exchangeBalance": "0",
        "logoUrl": "https://example.com/usdc.png"
      },
      {
        "address": "0x3333333333333333333333333333333333333333",
        "name": "Synfutures Apple Inc.",
        "symbol": "aAAPL",
        "stockSymbol": "AAPL",
        "isStock": true,
        "decimals": 18,
        "price": 180.5,
        "walletBalance": "0.25",
        "walletAllowance": "0",
        "exchangeBalance": "1.50",
        "logoUrl": "https://example.com/aapl.png"
      }
    ]
  },
  "uuid": null,
  "t": null
}

Interpretation:

• mUsdBalance is mUSD for buys and withdrawals.

• walletBalance is wallet-held ERC-20.

• exchangeBalance is the API view of Stock.stockBalance, used by plain sells.

• walletAllowance matters before deposits.

Order Calldata

{
  "code": 200,
  "errMsg": "",
  "data": {
    "chainId": 143,
    "productType": "Synfutures",
    "toAddress": "0x4444444444444444444444444444444444444444",
    "value": "0",
    "callData": "0xabcdef...",
    "method": "placeMarketOrder"
  },
  "uuid": null,
  "t": null
}

Submit toAddress, value, and callData exactly as returned.

Order Detail

{
  "code": 200,
  "errMsg": "",
  "data": {
    "openOrder": null,
    "historyOrder": {
      "orderId": "0x0000000000000001000200001111111111111111111111111111111111111111",
      "userAddress": "0x1111111111111111111111111111111111111111",
      "side": "Buy",
      "type": "Market",
      "tif": null,
      "symbol": "AAPL",
      "placeNotional": "10.00",
      "placeQuantity": null,
      "pay": "10.00",
      "placePrice": null,
      "status": "Filled",
      "settleTxHash": "0xdef...",
      "settlePrice": "180.50",
      "settlePay": "9.95",
      "settleReceive": "0.0551",
      "mintFee": "0.01",
      "protocolFee": "0.01"
    }
  },
  "uuid": null,
  "t": null
}

Deposit Detail

{
  "code": 200,
  "errMsg": "",
  "data": {
    "mappingStatus": "Filled",
    "operationStatus": "settled",
    "mapping": {
      "txHash": "0xabc...",
      "operationType": "deposit"
    },
    "depositOperation": {
      "operationId": "0x1234...",
      "userAddress": "0x1111111111111111111111111111111111111111",
      "tokenAddress": "0x2222222222222222222222222222222222222222",
      "status": "settled",
      "isInstant": true,
      "amount": 100,
      "creditAmount": 100,
      "feeAmount": 0,
      "createTxHash": "0xabc...",
      "settleTxHash": "0xdef..."
    },
    "withdrawalOperation": null
  },
  "uuid": null,
  "t": null
}

One Click Status

{
  "code": 200,
  "errMsg": "",
  "data": {
    "status": "enable",
    "delegatee": "0x5555555555555555555555555555555555555555"
  },
  "uuid": null,
  "t": null
}

Error Response

{
  "code": 401,
  "errMsg": "Unauthorized",
  "data": null,
  "uuid": "b3d8d0b5-2f93-4f4e-bf06-2f0e5a9f6d1f",
  "t": 1782390000000
}

Use uuid when escalating issues.

Market config

{
  "code": 200,
  "data": {
    "cashierBuffer": {
      "chain": 10143,
      "productType": "MondayTrade",
      "address": "0x....",
      "instantThresholdDivisor": "1",
      "creditBuffer": "743810467000000000000",
      "creditBufferCapacity": "1000000000000000000000",
      "totalBalance": "156027003229608600000"
    },
    "exchangeFeeConfig": {
      "chainId": 10143,
      "productType": "MondayTrade",
      "mintFeeRate": "0",
      "protocolFeeRate": "0",
      "minOrderValue": "0",
      "txHash": "",
      "updatedAt": 1778477709
    },
    "cashierTokenConfig": {
      "0x534b2f3a21130d7a60830c2df862319e593943a3": {
        "chain": 10143,
        "productType": "MondayTrade",
        "cashierAddress": "0x....",
        "tokenAddress": "0x534b2f3a21130d7a60830c2df862319e593943a3",
        "minAmount": "1",
        "decimals": 6,
        "depositPaused": false,
        "withdrawPaused": false,
        "depositRate": "1",
        "withdrawalBuffer": "253689533",
        "withdrawalBufferCapacity": "1000000000",
        "withdrawalRate": "0.9969"
      }
    }
  },
  "errMsg": "",
  "t": null,
  "uuid": null
}

Field names in cashierBuffer match the live OpenAPI schema (CashierBufferRespDto).