User Role

Endpoint

POST /info

Request Body

Parameter	Type	Description
type*	string	Must be "userRole"
user*	string	Address to check (case-insensitive), e.g., "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

Response

The response varies based on the address role:

User Account

{
  "role": "user"
}

API Wallet Agent

{
  "role": "agent",
  "data": {
    "user": "0x1234567890abcdef..."
  }
}

Address Not Found

{
  "role": "missing"
}

Response Fields

Field	Type	Description
role	string	Role type (“user”, “agent”, or “missing”)
data.user	string	Main user address (only for “agent” role)

Example Request

curl -X POST https://api.notional.xyz/info \
  -H "Content-Type: application/json" \
  -d '{
    "type": "userRole",
    "user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  }'

Error Responses

{
  "error": "Missing 'user' parameter"
}

HTTP Status: 400 Bad Request

Notes

• Role values: "user", "agent", "missing"
• Agents link to exactly one user via data.user field
• Address lookup is case-insensitive