blockreq_createEndpoint
Description
Creates a new endpoint on a specified blockchain network. Each account is limited to 100 endpoints. The response includes the generated API key and endpoint URLs.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
chain | string | Yes | Network slug (use blockreq_supportedNetworks to list available chains) |
name | string | No | Custom name for the endpoint (auto-generated if omitted) |
Returns
| Field | Type | Description |
|---|---|---|
endpointId | string | Unique endpoint identifier |
name | string | Endpoint name |
chain | string | Network slug |
status | string | Always active for new endpoints |
apiKey | string | Generated API key |
httpsUrl | string | HTTPS endpoint URL |
wssUrl | string | WebSocket endpoint URL |
Errors
| Code | Message | Description |
|---|---|---|
| -32602 | Invalid chain | Chain slug not in supported networks |
| -32003 | Endpoint limit reached (100) | Account has reached the maximum number of endpoints |
Request Example
{
"jsonrpc": "2.0",
"method": "blockreq_createEndpoint",
"params": [{ "chain": "ethereum", "name": "my-prod-endpoint" }],
"id": 1
}Response Example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"endpointId": "a1b2c3d4-...",
"name": "my-prod-endpoint",
"chain": "ethereum",
"status": "active",
"apiKey": "f8e7d6c5b4a3...",
"httpsUrl": "https://ethereum-rpc.blockreq.com/v1/rpc/f8e7d6c5b4a3...",
"wssUrl": "wss://ethereum-rpc.blockreq.com/v1/rpc/f8e7d6c5b4a3..."
}
}Code Examples
curl -X POST https://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000 \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"blockreq_createEndpoint","params":[{"chain":"ethereum","name":"my-prod-endpoint"}],"id":1}'