Create Network

post https://api.chainstack.com/v1/networks/

Create a network.

Body Params

name

string

required

Name of the network.

Required for consortium networks.
Autogenerated for public chain networks.

project

string

required

ID of the network's project.

protocol

string

required

Protocol.

See also Supported protocols.

configuration

required

Protocol-specific parameters.

Pass {} if there are no specific parameters for the chosen protocol.

nodes

array of objects

required

List of nodes that will be initially created.

nodes*

Responses

Response body

object

string

name

string

Name of the network.

project

string

ID of the network's project.

protocol

string

Protocol.

See also Supported protocols.

ethereum polygon-pos bsc avalanche arbitrum near aurora gnosis cronos fantom starknet harmony tezos fuse bitcoin

details

object

Has additional fields

status

string

See more about statuses.

pending ok failed warning stopping stopped starting

creator

object

Creator of the object.

string

first_name

string

last_name

string

organization

object

Common object representation.

created_at

date-time

When the object was created.

configuration

nodes

array of objects

nodes

object

string

name

string

Name of the node.

network

string

ID of the network.

organization

string

ID of the organization that owns this node.

type

string

Type of the node.

Available types:

shared — only for ethereum, polygon-pos, bsc, avalanche, fantom, tezos, bitcoin
dedicated — for all protocols

shared dedicated

provider

string

Cloud provider.

See also Supported cloud providers.

aws azure gcloud vzo

region

string

Regions the nodes are deployed to.

Available for gcloud:

asia-southeast1

Available for aws:

ap-southeast-1
us-west-2
us-east-1

Available for azure:

uksouth

Available for vzo:

eu3

asia-southeast1 ap-southeast-1 us-west-2 us-east-1 uksouth eu3

details

Protocol-specific attributes.

status

string

See more about statuses.

pending running maintenance failed error stopping stopped starting

creator

object

Creator of the object.

created_at

date-time

When the object was created.

role

string

Role of the node.

Available roles:

peer — peer node

peer

configuration

Language

Credentials

Bearer


xxxxxxxxxx
12
1
curl --request POST \
2
     --url https://api.chainstack.com/v1/networks/ \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "protocol": "ethereum",
8
  "configuration": {
9
    "network": "ethereum-mainnet"
10
  }
11
}
12
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201

400Validation error.