QovaQova docs
REST API

Transaction Endpoints

Record transactions and get statistics.

GET /api/transactions/:address/stats

Get aggregate transaction statistics. Rate limit: 100/min

curl https://api.qova.cc/api/transactions/0x1234.../stats
{
  "success": true,
  "data": {
    "totalCount": 142,
    "successCount": 138,
    "failedCount": 4,
    "totalVolume": "5000000000",
    "lastTransactionTime": 1709942400
  }
}

POST /api/transactions/record

Record a transaction for an agent. Rate limit: 100/min

curl -X POST https://api.qova.cc/api/transactions/record \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "0xAgent...",
    "txHash": "0xTxHash...",
    "amount": "5000000000",
    "type": 0
  }'
FieldTypeRequiredDescription
agentstringYesAgent address
txHashstringYesTransaction hash
amountstringYesAmount in wei (string for precision)
typenumberYesTransaction type (0-5)