API Reference

Base URLs

Authentication

Public RPC endpoints are rate-limited but require no authentication for standard read operations. For higher rate limits, include your API key in the header:

curl https://api.quantumdex.io/v1/karma/0x1234... \
  -H "X-API-Key: qb_live_your_api_key_here"

API keys are available from the Developer Dashboard (launching with testnet).

JSON-RPC Methods

ThiChain L1 is EVM-compatible and supports all standard Ethereum JSON-RPC methods plus ThiChain-specific extensions:

Standard Methods (inherited from Ethereum)

// Get block number
{ "method": "eth_blockNumber", "params": [] }

// Get balance
{ "method": "eth_getBalance", "params": ["0x...", "latest"] }

// Send transaction
{ "method": "eth_sendRawTransaction", "params": ["0x...signedTx"] }

// Call contract
{ "method": "eth_call", "params": [{ "to": "0x...", "data": "0x..." }, "latest"] }

ThiChain Extensions

// Get karma score
{ "method": "thichain_getKarmaScore", "params": ["0xWalletAddress"] }
// Returns: { "score": 420, "tier": "PRACTITIONER", "lastUpdated": "0x..." }

// Get dharmic validation result
{ "method": "thichain_dharmicValidate",
  "params": ["0xContractAddress", "0xCalldata"] }
// Returns: { "passed": true, "yamaScores": {...}, "overallScore": 0.87 }

// Get consciousness score (if opted in)
{ "method": "thichain_getConsciousnessScore", "params": ["0xAddress"] }
// Returns: { "dimensions": {...}, "overallScore": 72.4 }

REST Endpoints

Karma

Pools

Routing

// POST /route/quote
{
  "tokenIn": "0x...USDC",
  "tokenOut": "0x...THI",
  "amountIn": "100000000",      // 100 USDC in wei
  "walletAddress": "0x..."      // optional — for karma fee lookup
}
// Response
{
  "amountOut": "98450000000000000000",
  "priceImpact": "0.012",
  "feeBps": 15,
  "karmaTier": "PRACTITIONER",
  "route": [{ "pair": "0x...", "fee": 15 }]
}

ThiChain Precompiles

ThiChain L1 exposes consciousness and dharmic functionality as EVM precompiles — callable from Solidity contracts or directly via eth_call:

// Call KarmaOracle precompile directly (Solidity)
(bool success, bytes memory result) = address(0x0421).staticcall(
    abi.encode(userAddress)
);
uint256 karmaScore = abi.decode(result, (uint256));

Rate Limits