POST /api/v1/watchlist/bulk
Add up to 100 ENS names to a watchlist at once. Names already on the list are skipped. Names not found in the database are reported in the response.
Authentication: Required
Cache: None
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
ensNames | string[] | Yes | ENS names to add (1–100) |
listId | number | No | Target list ID (defaults to user’s default list) |
Sample Request
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
https://api.grails.app/api/v1/watchlist/bulk \
-d '{ "ensNames": ["example.eth", "test.eth", "hello.eth"] }'Response
// 200 OK
{
"success": true,
"data": {
"added": 8,
"alreadyExisted": 2,
"notFound": 1
},
"meta": {
"timestamp": "2026-04-08T00:00:00.000Z",
"version": "1.0.0"
}
}Error Responses
| Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | Invalid request body |
| 404 | ENS_NAMES_NOT_FOUND | None of the specified names were found |
| 404 | LIST_NOT_FOUND | Specified list not found |
Last updated on