Skip to main content
POST
https://win.oneshotagent.com
/
v1
/
tools
/
email
/
quote
curl -X POST https://win.oneshotagent.com/v1/tools/email/quote \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <your_x402_signature>" \
  -d '{
    "from_address": "[email protected]",
    "to_address": "[email protected]",
    "subject": "Hello",
    "body": "Test email"
  }'

{
  "domain": "yourdomain.com",
  "is_new": true,
  "available": true,
  "registration_fee": 10.00,
  "service_fee": 0.01,
  "total_cost": 10.01,
  "currency": "USD",
  "quote_id": "quote_abc123",
  "status": "unprovisioned"
}

​
Authentication

Requires X-Agent-ID header with your wallet address.

​
Request Body

​
from_address
string
required
Sender email address (e.g., [email protected])
​
to_address
string | string[]
required
Recipient email address(es)
​
subject
string
required
Email subject line
​
body
string
required
Email body content (plain text)

​
Response

​
domain
string
Domain extracted from from_address
​
is_new
boolean
Whether this is a new domain that needs registration
​
available
boolean
Whether the domain is available for registration
​
registration_fee
number
Cost to register the domain (USD)
​
service_fee
number
Cost to send the email (USD)
​
total_cost
number
Total cost (registration + service fees)
​
quote_id
string
Quote ID to use in the send request
​
status
string
Domain status: verified, provisioning, unprovisioned, or blocked
curl -X POST https://win.oneshotagent.com/v1/tools/email/quote \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <your_x402_signature>" \
  -d '{
    "from_address": "[email protected]",
    "to_address": "[email protected]",
    "subject": "Hello",
    "body": "Test email"
  }'

{
  "domain": "yourdomain.com",
  "is_new": true,
  "available": true,
  "registration_fee": 10.00,
  "service_fee": 0.01,
  "total_cost": 10.01,
  "currency": "USD",
  "quote_id": "quote_abc123",
  "status": "unprovisioned"
}

​
Bulk Usage

You can request a quote for sending independent emails to multiple recipients in a single request. Pass an array of strings to to_address.
The service_fee will scale based on the number of recipients. The registration_fee (if applicable) remains a one-time cost for the domain.
curl -X POST https://win.oneshotagent.com/v1/tools/email/quote \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <your_x402_signature>" \
  -d '{
    "from_address": "[email protected]",
    "to_address": ["[email protected]", "[email protected]", "[email protected]"],
    "subject": "Hello Team",
    "body": "Weekly update..."
  }'

​
Notes

  • Domain provisioning happens automatically during the send request
  • Quote is valid for 1 hour
  • For existing verified domains, registration_fee will be 0