How to create address books?
Process of creating address book
Arrange Data
Arrange address book data in the format
{
"name": "string"
"addresses": {
"address": "address",
"chainType": "EVM" | "APTOS" | "SOLANA",
"name": "string"
}[],
"walletIds": {
"walletId": "string",
"name": "string"
},
"ownerId": "string"
}Generate & Sign Message
Generate message using this API and above data
Authorizations
Body
idintegerOptional
namestringRequired
addressesstring[]Optional
walletIdsstring[]Optional
ownerstringRequired
createdAtstring · date-timeOptional
updatedAtstring · date-timeRequired
Responses
201
Successful response
application/json
400Error
application/json
401Error
application/json
post
POST /v1/address-books/message HTTP/1.1
Host: sandbox-api.fetcch.xyz
secret-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 157
{
"id": 1,
"name": "text",
"addresses": [
"text"
],
"walletIds": [
"text"
],
"owner": "text",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}{
"data": {
"message": "text",
"book": {
"id": 1,
"name": "text",
"addresses": [
{
"id": 1,
"address": "text",
"chainType": "EVM",
"name": "text",
"addressBookId": 1,
"addressBook": {
"id": 1,
"name": "text",
"addresses": "[Circular Reference]",
"walletIds": "[Circular Reference]",
"ownerId": "text",
"owner": "[Circular Reference]",
"requests": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
}
],
"walletIds": [
{
"id": 1,
"walletId": "text",
"wallet": {
"id": "text",
"identifier": "text",
"providerId": "text",
"provider": "[Circular Reference]",
"defaultAddress": "text",
"default": {
"address": "text",
"chain": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"chainId": 1,
"isMultisig": false,
"isSmartContractWallet": false,
"walletId": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"secondary": "[Circular Reference]",
"nonce": 0,
"currentSignature": "text",
"previousSignature": "text",
"isContract": false,
"syncedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"name": "text",
"addressBookId": 1,
"addressBook": {
"id": 1,
"name": "text",
"addresses": "[Circular Reference]",
"walletIds": "[Circular Reference]",
"ownerId": "text",
"owner": "[Circular Reference]",
"requests": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
],
"ownerId": "text",
"owner": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": {
"id": "text",
"identifier": "text",
"providerId": "text",
"provider": {
"id": "text",
"logo": "text",
"apiKey": "text",
"delimiter": "text",
"txHash": "text",
"registry": "[Circular Reference]",
"dataSourceId": 1,
"ownerId": "text",
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"defaultAddress": "text",
"default": {
"address": "text",
"chain": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"chainId": 1,
"isMultisig": false,
"isSmartContractWallet": false,
"walletId": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"secondary": [
"[Circular Reference]"
],
"nonce": 0,
"currentSignature": "text",
"previousSignature": "text",
"isContract": false,
"syncedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"requests": [
{
"id": 1,
"bookId": 1,
"book": {
"id": 1,
"name": "text",
"addresses": "[Circular Reference]",
"walletIds": "[Circular Reference]",
"ownerId": "text",
"owner": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": {
"id": "text",
"identifier": "text",
"providerId": "text",
"provider": {
"id": "text",
"logo": "text",
"apiKey": "text",
"delimiter": "text",
"txHash": "text",
"registry": "[Circular Reference]",
"dataSourceId": 1,
"ownerId": "text",
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"defaultAddress": "text",
"default": {
"address": "text",
"chain": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"chainId": 1,
"isMultisig": false,
"isSmartContractWallet": false,
"walletId": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"secondary": [
"[Circular Reference]"
],
"nonce": 0,
"currentSignature": "text",
"previousSignature": "text",
"isContract": false,
"syncedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"requests": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"toId": "text",
"to": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": {
"id": "text",
"identifier": "text",
"providerId": "text",
"provider": {
"id": "text",
"logo": "text",
"apiKey": "text",
"delimiter": "text",
"txHash": "text",
"registry": "[Circular Reference]",
"dataSourceId": 1,
"ownerId": "text",
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"defaultAddress": "text",
"default": {
"address": "text",
"chain": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"chainId": 1,
"isMultisig": false,
"isSmartContractWallet": false,
"walletId": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"secondary": [
"[Circular Reference]"
],
"nonce": 0,
"currentSignature": "text",
"previousSignature": "text",
"isContract": false,
"syncedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"access": "READ",
"pending": true,
"accepted": false,
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
],
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
},
"status": 1,
"timestamp": "2025-06-25T10:35:31.043Z"
}Sign the above message by following signature guidelines mentioned here according to the chain you are using
Call Create Address Book API
Authorizations
Body
idintegerOptional
signaturestringOptional
namestringRequired
addressesstring[]Optional
walletIdsstring[]Optional
ownerstringRequired
createdAtstring · date-timeOptional
updatedAtstring · date-timeRequired
Responses
201
Successful response
application/json
400Error
application/json
401Error
application/json
post
POST /v1/address-books HTTP/1.1
Host: sandbox-api.fetcch.xyz
secret-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 176
{
"id": 1,
"signature": "text",
"name": "text",
"addresses": [
"text"
],
"walletIds": [
"text"
],
"owner": "text",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}{
"data": {
"id": 1,
"name": "text",
"addresses": [
{
"id": 1,
"address": "text",
"chainType": "EVM",
"name": "text",
"addressBookId": 1,
"addressBook": {
"id": 1,
"name": "text",
"addresses": [
"[Circular Reference]"
],
"walletIds": [
"[Circular Reference]"
],
"ownerId": "text",
"owner": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"requests": [
"[Circular Reference]"
],
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
}
],
"walletIds": [
{
"id": 1,
"walletId": "text",
"wallet": {
"id": "text",
"identifier": "text",
"providerId": "text",
"provider": {
"id": "text",
"logo": "text",
"apiKey": "text",
"delimiter": "text",
"txHash": "text",
"registry": "[Circular Reference]",
"dataSourceId": 1,
"ownerId": "text",
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"defaultAddress": "text",
"default": {
"address": "text",
"chain": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"chainId": 1,
"isMultisig": false,
"isSmartContractWallet": false,
"walletId": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"secondary": [
"[Circular Reference]"
],
"nonce": 0,
"currentSignature": "text",
"previousSignature": "text",
"isContract": false,
"syncedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"name": "text",
"addressBookId": 1,
"addressBook": {
"id": 1,
"name": "text",
"addresses": [
{
"id": 1,
"address": "text",
"chainType": "EVM",
"name": "text",
"addressBookId": 1,
"addressBook": {
"id": 1,
"name": "text",
"addresses": [
"[Circular Reference]"
],
"walletIds": [
"[Circular Reference]"
],
"ownerId": "text",
"owner": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"requests": [
"[Circular Reference]"
],
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
}
],
"walletIds": [
"[Circular Reference]"
],
"ownerId": "text",
"owner": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"requests": [
"[Circular Reference]"
],
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
],
"ownerId": "text",
"owner": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"requests": [
{
"id": 1,
"bookId": 1,
"book": {
"id": 1,
"name": "text",
"addresses": [
{
"id": 1,
"address": "text",
"chainType": "EVM",
"name": "text",
"addressBookId": 1,
"addressBook": {
"id": 1,
"name": "text",
"addresses": [
"[Circular Reference]"
],
"walletIds": [
"[Circular Reference]"
],
"ownerId": "text",
"owner": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"requests": [
"[Circular Reference]"
],
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
}
],
"walletIds": [
{
"id": 1,
"walletId": "text",
"wallet": {
"id": "text",
"identifier": "text",
"providerId": "text",
"provider": {
"id": "text",
"logo": "text",
"apiKey": "text",
"delimiter": "text",
"txHash": "text",
"registry": "[Circular Reference]",
"dataSourceId": 1,
"ownerId": "text",
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"defaultAddress": "text",
"default": {
"address": "text",
"chain": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"chainId": 1,
"isMultisig": false,
"isSmartContractWallet": false,
"walletId": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"secondary": [
"[Circular Reference]"
],
"nonce": 0,
"currentSignature": "text",
"previousSignature": "text",
"isContract": false,
"syncedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"name": "text",
"addressBookId": 1,
"addressBook": {
"id": 1,
"name": "text",
"addresses": [
{
"id": 1,
"address": "text",
"chainType": "EVM",
"name": "text",
"addressBookId": 1,
"addressBook": {
"id": 1,
"name": "text",
"addresses": [
"[Circular Reference]"
],
"walletIds": [
"[Circular Reference]"
],
"ownerId": "text",
"owner": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"requests": [
"[Circular Reference]"
],
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
}
],
"walletIds": [
"[Circular Reference]"
],
"ownerId": "text",
"owner": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"requests": [
"[Circular Reference]"
],
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
],
"ownerId": "text",
"owner": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": "[Circular Reference]",
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"requests": [
"[Circular Reference]"
],
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"toId": "text",
"to": {
"owner": "text",
"ownerId": "text",
"ownerIdentity": {
"id": "text",
"identifier": "text",
"providerId": "text",
"provider": {
"id": "text",
"logo": "text",
"apiKey": "text",
"delimiter": "text",
"txHash": "text",
"registry": "[Circular Reference]",
"dataSourceId": 1,
"ownerId": "text",
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"defaultAddress": "text",
"default": {
"address": "text",
"chain": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"chainId": 1,
"isMultisig": false,
"isSmartContractWallet": false,
"walletId": {
"id": 1,
"name": "text",
"symbol": "text",
"icon": "text",
"rpc": [
"text"
],
"type": "EVM",
"shortName": "text",
"infoURL": "text",
"chainId": 1,
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"updatedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"secondary": "[Circular Reference]",
"nonce": 0,
"currentSignature": "text",
"previousSignature": "text",
"isContract": false,
"syncedAt": "2025-06-25T10:35:31.043Z",
"createdAt": "2025-06-25T10:35:31.043Z"
},
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"access": "READ",
"pending": true,
"accepted": false,
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
}
],
"createdAt": "2025-06-25T10:35:31.043Z",
"updatedAt": "2025-06-25T10:35:31.043Z"
},
"status": 1,
"timestamp": "2025-06-25T10:35:31.043Z"
}Last updated