Skip to main content

x402 leases

x402 leases are signed, time-bounded access grants for autonomous agents.

Request a lease:

curl -i https://api.marking.fyi/v1/leases \
-H "Content-Type: application/json" \
-d '{
"consumerId": "agent-001",
"feedIds": ["btc-usd", "eth-usd"],
"durationSeconds": 600,
"capabilities": ["stream"]
}'

If payment is required, the API returns HTTP 402 with payment requirements. After the x402 payment is verified/settled, repeat the request with the payment proof and receive a signed lease.

Lease payloads include:

  • consumer ID;
  • authorized feed IDs;
  • capability set;
  • issue and expiry timestamps;
  • payment ID;
  • nonce;
  • concurrency limit;
  • optional delegation.

Leases are for paid agent access. Durable server/protocol access should use API keys.