SID API

SPACE ID also provides a free HTTP API with a rate limit to help Dapps integrate the name-resolving and reverse-name-resolving services.

Resolve Names

GET https://api.prd.space.id/v1/getAddress?tld=&domain=

Query Parameters

Name	Type	Description
tld*	String	top level domain, ex: bnb, arb1
domain*	String	domain name, ex: allen.bnb

200: OK domain is valid and domain has been registered

{
    "code": 0,
    "address": "0x0e76a6dC9af8080b48C51E564e964CD15b9D6664"
}

200: OK domain is valid but the domain has not been registered

{
    "code": 0,
    "address": "0x0000000000000000000000000000000000000000"
}

200: OK domain name is invalid

{
    "code": 1,
    "msg": "invalid name"
    
}

200: OK RPC has error connecting to node

{
"code": 1,
"msg": "rpc error"
}

Request URL Example:

https://api.prd.space.id/v1/getAddress?tld=bnb&domain=allen.bnb

https://api.prd.space.id/v1/getAddress?tld=arb1&domain=allen.arb

Reverse Resolve Names

GET https://api.prd.space.id/v1/getName?tld=&address=

Query Parameters

Name	Type	Description
tld	String	top-level domain, ex: bnb, arb1
address	String	address

200: OK address has a valid primary name

{
"code": 0,
"name": "allen.bnb"
}

200: OK address does not have a valid primary name

{
"code": 0,
"name": null
}

200: OK RPC has error connecting to node

{
"code": 1,
"msg": "rpc error"
}

Request URL Example:

https://api.prd.space.id/v1/getName?tld=bnb&address=0x2e552E3aD9f7446e9caB378c008315E0C26c0398

https://api.prd.space.id/v1/getName?tld=arb1&address=0x2e552E3aD9f7446e9caB378c008315E0C26c0398