"method" : "POST" , "content_type" : "application/json" ,
"price_usd" : 0.004 , // 4000 atomic USDC (6 decimals)
"network" : "eip155:8453" , // Base mainnet
"asset" : "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" , // USDC
"payTo" : "0xc22f9CAEBAc37fE72D5142f35f21f6696Ea9Ef69" ,
"you_provide" : { // JSON body fields
"text" : required
string
★
The text whose tokens you want to count (prompt, document, chat log...).
Required · string
Example: "hello agent"
use example values clear
},
"request_body" : // live, from your inputs
{
"text": "hello agent",
"encoding": "cl100k_base"
}
"you_get" : { // HTTP 200 application/json after payment
"output_schema" :
{
"type": "object",
"properties": {
"skill": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"encoding": {
"type": "string"
},
"chars": {
"type": "integer"
},
"words": {
"type": "integer"
},
"approx_tokens": {
"type": "integer"
},
"usd_hint_gpt4o_mini": {
"type": "number"
}
},
"required": [
"ok",
"skill"
]
}
"example" :
{
"skill": "token_count",
"ok": true,
"encoding": "cl100k_base",
"chars": 11,
"words": 2,
"approx_tokens": 2,
"usd_hint_gpt4o_mini": 3e-07
}
},
"flow" : [
POST https://grokzilla.shop/api/skills/token-count with the JSON body, no payment header← 402 Payment Required + PAYMENT-REQUIRED header: base64 JSON {x402Version: 2, accepts: [{scheme: "exact", network: "eip155:8453", asset: USDC, amount: "4000", payTo}]} (same JSON in the body)
your x402 client checks amount ≤ $0.004 and signs a USDC transfer authorization to payTo with your wallet
retry the same POST with PAYMENT-SIGNATURE: <base64> (x402 v2) or X-PAYMENT (v1 clients)
← 200 OK with the result JSON + PAYMENT-RESPONSE header (base64 settlement receipt, tx hash on Base)
],
"copy" : { // fills in from your inputs as you type
"curl" // unpaid: shows the 402 copy
"agentcash" // pays from your AgentCash wallet copy
},
"try" : // POSTs unpaid to /api/skills/token-count on this host and decodes the 402. Never pays.
Send unpaid request
}