Skip to main content
GET
/
v1
/
free-tier
/
info
Free Tier
curl --request GET \
  --url https://api.memoclaw.com/v1/free-tier/info \
  --header 'x-wallet-auth: <x-wallet-auth>'
{
  "wallet": "<string>",
  "free_tier_remaining": 123,
  "free_tier_total": 123,
  "free_tier_used": 123
}
Every wallet gets 100 free API calls to paid endpoints. No payment required to start.
Free endpoints (list, get, delete, search, suggested, relations, history, graph, export, namespaces, stats) don’t consume free tier credits.

​
GET /v1/free-tier/info

Public endpoint (no auth required). Returns free tier policy.
curl
curl https://api.memoclaw.com/v1/free-tier/info
Response
{
  "free_tier": {
    "enabled": true,
    "calls_per_wallet": 100,
    "description": "Every wallet gets 100 free API calls. No payment required."
  },
  "auth": {
    "header": "x-wallet-auth",
    "format": "{wallet_address}:{unix_timestamp}:{signature}",
    "message_to_sign": "memoclaw-auth:{unix_timestamp}",
    "expiry_seconds": 300
  },
  "after_free_tier": {
    "payment": "x402 (USDC on Base)",
    "note": "Only endpoints using OpenAI are charged. See /reference/pricing for details."
  }
}

​
GET /v1/free-tier/status

Check your remaining free tier calls. Requires wallet authentication.

​
Headers

​
x-wallet-auth
string
required
Format: {address}:{timestamp}:{signature}

​
Response

​
wallet
string
Your wallet address.
​
free_tier_remaining
number
Calls remaining in free tier.
​
free_tier_total
number
Total free tier allowance (100).
​
free_tier_used
number
Calls already used.

​
Example

curl https://api.memoclaw.com/v1/free-tier/status \
  -H "x-wallet-auth: 0xYourWallet:1699900000:0xSignature..."
Response
{
  "wallet": "0x1234...abcd",
  "free_tier_remaining": 87,
  "free_tier_total": 100,
  "free_tier_used": 13
}