API Reference

Complete endpoint documentation for programmatic token management on Novault.

Base URL

https://api.novault.tech/v1

Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits

Free tier: 100 requests/hour
Pro tier: 1,000 requests/hour
Enterprise: Custom limits

Token Endpoints

Deploy Token

POST /tokens/deploy

Parameters

Parameter	Type	Description
`name`	string	Token name (e.g., "MyToken")
`symbol`	string	Token symbol (e.g., "MTK")
`supply`	number	Total supply in wei
`decimals`	number	Decimal places (usually 18)

Response

{
  "success": true,
  "token_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f...",
  "tx_hash": "0x1234567890abcdef...",
  "created_at": "2026-08-20T10:30:00Z"
}

Get Token Info

GET /tokens/{address}

Response

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f...",
  "name": "MyToken",
  "symbol": "MTK",
  "supply": "1000000000000000000000000000",
  "decimals": 18,
  "creator": "0xABC...",
  "created_at": "2026-08-20T10:30:00Z",
  "holders": 5420,
  "transfers": 124560
}

Liquidity Endpoints

Add Liquidity

POST /liquidity/add

Parameters

Parameter	Type	Description
`token_address`	string	Token contract address
`token_amount`	number	Amount of tokens to add
`eth_amount`	number	Amount of ETH to add (in wei)
`lock_duration`	number	Lock duration in seconds (optional)

Response

{
  "success": true,
  "pool_id": "POOL_123456",
  "liquidity_tokens": "1000000000000000000",
  "tx_hash": "0x...",
  "lock_expires_at": "2025-08-20T10:30:00Z"
}

Get Pool Stats

GET /liquidity/{pool_id}

Response

{
  "pool_id": "POOL_123456",
  "token_address": "0x742d...",
  "token_reserve": "500000000000000000000000000",
  "eth_reserve": "10000000000000000000",
  "liquidity_locked": true,
  "lock_expires_at": "2025-08-20",
  "price_usd": 0.000050,
  "volume_24h": 1250000,
  "holders": 5420
}

Rewards Endpoints

Claim Rewards

POST /rewards/claim

Parameters

Parameter	Type	Description
`token_address`	string	Token contract address

Response

{
  "success": true,
  "amount_claimed": "500000000000000000",
  "tx_hash": "0x...",
  "claimed_at": "2026-08-20T10:30:00Z"
}

Get Reward Balance

GET /rewards/{token_address}

Response

{
  "token_address": "0x742d...",
  "pending_rewards": "1250000000000000000",
  "claimed_rewards": "5000000000000000000",
  "total_rewards": "6250000000000000000",
  "last_claim": "2026-08-19T10:30:00Z"
}

Error Responses

All errors follow this format:

{
  "success": false,
  "error": "Invalid token address",
  "error_code": "INVALID_ADDRESS",
  "status": 400
}

Common Error Codes

INVALID_ADDRESS - Invalid Ethereum address format
INSUFFICIENT_BALANCE - Not enough tokens/ETH
UNAUTHORIZED - Invalid or missing API key
RATE_LIMITED - Too many requests
NETWORK_ERROR - Blockchain network error

Code Examples

See Code Examples for Python, JavaScript, and cURL examples.

💡 Pro Tip

Always use the testnet endpoints first to validate your integration before going to mainnet.