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

Generate message for address book

post

/address-books/message

Authorizations

secret-keystringRequired

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

/address-books/message

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-12-28T12:09:57.232Z",
  "updatedAt": "2025-12-28T12:09:57.232Z"
}

{
  "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-12-28T12:09:57.232Z",
            "updatedAt": "2025-12-28T12:09:57.232Z"
          }
        }
      ],
      "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-12-28T12:09:57.232Z",
                "createdAt": "2025-12-28T12:09:57.232Z"
              },
              "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-12-28T12:09:57.232Z",
                "createdAt": "2025-12-28T12:09:57.232Z"
              },
              "updatedAt": "2025-12-28T12:09:57.232Z",
              "createdAt": "2025-12-28T12:09:57.232Z"
            },
            "secondary": "[Circular Reference]",
            "nonce": 0,
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": false,
            "syncedAt": "2025-12-28T12:09:57.232Z",
            "createdAt": "2025-12-28T12:09:57.232Z"
          },
          "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-12-28T12:09:57.232Z",
            "updatedAt": "2025-12-28T12:09:57.232Z"
          },
          "createdAt": "2025-12-28T12:09:57.232Z",
          "updatedAt": "2025-12-28T12:09:57.232Z"
        }
      ],
      "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-12-28T12:09:57.232Z",
            "createdAt": "2025-12-28T12:09:57.232Z"
          },
          "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-12-28T12:09:57.232Z",
              "createdAt": "2025-12-28T12:09:57.232Z"
            },
            "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-12-28T12:09:57.232Z",
              "createdAt": "2025-12-28T12:09:57.232Z"
            },
            "updatedAt": "2025-12-28T12:09:57.232Z",
            "createdAt": "2025-12-28T12:09:57.232Z"
          },
          "secondary": [
            "[Circular Reference]"
          ],
          "nonce": 0,
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": false,
          "syncedAt": "2025-12-28T12:09:57.232Z",
          "createdAt": "2025-12-28T12:09:57.232Z"
        },
        "createdAt": "2025-12-28T12:09:57.232Z",
        "updatedAt": "2025-12-28T12:09:57.232Z"
      },
      "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-12-28T12:09:57.232Z",
                  "createdAt": "2025-12-28T12:09:57.232Z"
                },
                "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-12-28T12:09:57.232Z",
                    "createdAt": "2025-12-28T12:09:57.232Z"
                  },
                  "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-12-28T12:09:57.232Z",
                    "createdAt": "2025-12-28T12:09:57.232Z"
                  },
                  "updatedAt": "2025-12-28T12:09:57.232Z",
                  "createdAt": "2025-12-28T12:09:57.232Z"
                },
                "secondary": [
                  "[Circular Reference]"
                ],
                "nonce": 0,
                "currentSignature": "text",
                "previousSignature": "text",
                "isContract": false,
                "syncedAt": "2025-12-28T12:09:57.232Z",
                "createdAt": "2025-12-28T12:09:57.232Z"
              },
              "createdAt": "2025-12-28T12:09:57.232Z",
              "updatedAt": "2025-12-28T12:09:57.232Z"
            },
            "requests": "[Circular Reference]",
            "createdAt": "2025-12-28T12:09:57.232Z",
            "updatedAt": "2025-12-28T12:09:57.232Z"
          },
          "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-12-28T12:09:57.232Z",
                "createdAt": "2025-12-28T12:09:57.232Z"
              },
              "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-12-28T12:09:57.232Z",
                  "createdAt": "2025-12-28T12:09:57.232Z"
                },
                "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-12-28T12:09:57.232Z",
                  "createdAt": "2025-12-28T12:09:57.232Z"
                },
                "updatedAt": "2025-12-28T12:09:57.232Z",
                "createdAt": "2025-12-28T12:09:57.232Z"
              },
              "secondary": [
                "[Circular Reference]"
              ],
              "nonce": 0,
              "currentSignature": "text",
              "previousSignature": "text",
              "isContract": false,
              "syncedAt": "2025-12-28T12:09:57.232Z",
              "createdAt": "2025-12-28T12:09:57.232Z"
            },
            "createdAt": "2025-12-28T12:09:57.232Z",
            "updatedAt": "2025-12-28T12:09:57.232Z"
          },
          "access": "READ",
          "pending": true,
          "accepted": false,
          "createdAt": "2025-12-28T12:09:57.232Z",
          "updatedAt": "2025-12-28T12:09:57.232Z"
        }
      ],
      "createdAt": "2025-12-28T12:09:57.232Z",
      "updatedAt": "2025-12-28T12:09:57.232Z"
    }
  },
  "status": 1,
  "timestamp": "2025-12-28T12:09:57.232Z"
}

Sign the above message by following signature guidelines mentioned here according to the chain you are using

Call Create Address Book API

Create Address Book

post

/address-books

Authorizations

secret-keystringRequired

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

/address-books

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-12-28T12:09:57.232Z",
  "updatedAt": "2025-12-28T12:09:57.232Z"
}

{
  "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-12-28T12:09:57.232Z",
            "updatedAt": "2025-12-28T12:09:57.232Z"
          },
          "requests": [
            "[Circular Reference]"
          ],
          "createdAt": "2025-12-28T12:09:57.232Z",
          "updatedAt": "2025-12-28T12:09:57.232Z"
        }
      }
    ],
    "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-12-28T12:09:57.232Z",
            "createdAt": "2025-12-28T12:09:57.232Z"
          },
          "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-12-28T12:09:57.232Z",
              "createdAt": "2025-12-28T12:09:57.232Z"
            },
            "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-12-28T12:09:57.232Z",
              "createdAt": "2025-12-28T12:09:57.232Z"
            },
            "updatedAt": "2025-12-28T12:09:57.232Z",
            "createdAt": "2025-12-28T12:09:57.232Z"
          },
          "secondary": [
            "[Circular Reference]"
          ],
          "nonce": 0,
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": false,
          "syncedAt": "2025-12-28T12:09:57.232Z",
          "createdAt": "2025-12-28T12:09:57.232Z"
        },
        "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-12-28T12:09:57.232Z",
                  "updatedAt": "2025-12-28T12:09:57.232Z"
                },
                "requests": [
                  "[Circular Reference]"
                ],
                "createdAt": "2025-12-28T12:09:57.232Z",
                "updatedAt": "2025-12-28T12:09:57.232Z"
              }
            }
          ],
          "walletIds": [
            "[Circular Reference]"
          ],
          "ownerId": "text",
          "owner": {
            "owner": "text",
            "ownerId": "text",
            "ownerIdentity": "[Circular Reference]",
            "createdAt": "2025-12-28T12:09:57.232Z",
            "updatedAt": "2025-12-28T12:09:57.232Z"
          },
          "requests": [
            "[Circular Reference]"
          ],
          "createdAt": "2025-12-28T12:09:57.232Z",
          "updatedAt": "2025-12-28T12:09:57.232Z"
        },
        "createdAt": "2025-12-28T12:09:57.232Z",
        "updatedAt": "2025-12-28T12:09:57.232Z"
      }
    ],
    "ownerId": "text",
    "owner": {
      "owner": "text",
      "ownerId": "text",
      "ownerIdentity": "[Circular Reference]",
      "createdAt": "2025-12-28T12:09:57.232Z",
      "updatedAt": "2025-12-28T12:09:57.232Z"
    },
    "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-12-28T12:09:57.232Z",
                  "updatedAt": "2025-12-28T12:09:57.232Z"
                },
                "requests": [
                  "[Circular Reference]"
                ],
                "createdAt": "2025-12-28T12:09:57.232Z",
                "updatedAt": "2025-12-28T12:09:57.232Z"
              }
            }
          ],
          "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-12-28T12:09:57.232Z",
                  "createdAt": "2025-12-28T12:09:57.232Z"
                },
                "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-12-28T12:09:57.232Z",
                    "createdAt": "2025-12-28T12:09:57.232Z"
                  },
                  "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-12-28T12:09:57.232Z",
                    "createdAt": "2025-12-28T12:09:57.232Z"
                  },
                  "updatedAt": "2025-12-28T12:09:57.232Z",
                  "createdAt": "2025-12-28T12:09:57.232Z"
                },
                "secondary": [
                  "[Circular Reference]"
                ],
                "nonce": 0,
                "currentSignature": "text",
                "previousSignature": "text",
                "isContract": false,
                "syncedAt": "2025-12-28T12:09:57.232Z",
                "createdAt": "2025-12-28T12:09:57.232Z"
              },
              "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-12-28T12:09:57.232Z",
                        "updatedAt": "2025-12-28T12:09:57.232Z"
                      },
                      "requests": [
                        "[Circular Reference]"
                      ],
                      "createdAt": "2025-12-28T12:09:57.232Z",
                      "updatedAt": "2025-12-28T12:09:57.232Z"
                    }
                  }
                ],
                "walletIds": [
                  "[Circular Reference]"
                ],
                "ownerId": "text",
                "owner": {
                  "owner": "text",
                  "ownerId": "text",
                  "ownerIdentity": "[Circular Reference]",
                  "createdAt": "2025-12-28T12:09:57.232Z",
                  "updatedAt": "2025-12-28T12:09:57.232Z"
                },
                "requests": [
                  "[Circular Reference]"
                ],
                "createdAt": "2025-12-28T12:09:57.232Z",
                "updatedAt": "2025-12-28T12:09:57.232Z"
              },
              "createdAt": "2025-12-28T12:09:57.232Z",
              "updatedAt": "2025-12-28T12:09:57.232Z"
            }
          ],
          "ownerId": "text",
          "owner": {
            "owner": "text",
            "ownerId": "text",
            "ownerIdentity": "[Circular Reference]",
            "createdAt": "2025-12-28T12:09:57.232Z",
            "updatedAt": "2025-12-28T12:09:57.232Z"
          },
          "requests": [
            "[Circular Reference]"
          ],
          "createdAt": "2025-12-28T12:09:57.232Z",
          "updatedAt": "2025-12-28T12:09:57.232Z"
        },
        "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-12-28T12:09:57.232Z",
              "createdAt": "2025-12-28T12:09:57.232Z"
            },
            "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-12-28T12:09:57.232Z",
                "createdAt": "2025-12-28T12:09:57.232Z"
              },
              "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-12-28T12:09:57.232Z",
                "createdAt": "2025-12-28T12:09:57.232Z"
              },
              "updatedAt": "2025-12-28T12:09:57.232Z",
              "createdAt": "2025-12-28T12:09:57.232Z"
            },
            "secondary": "[Circular Reference]",
            "nonce": 0,
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": false,
            "syncedAt": "2025-12-28T12:09:57.232Z",
            "createdAt": "2025-12-28T12:09:57.232Z"
          },
          "createdAt": "2025-12-28T12:09:57.232Z",
          "updatedAt": "2025-12-28T12:09:57.232Z"
        },
        "access": "READ",
        "pending": true,
        "accepted": false,
        "createdAt": "2025-12-28T12:09:57.232Z",
        "updatedAt": "2025-12-28T12:09:57.232Z"
      }
    ],
    "createdAt": "2025-12-28T12:09:57.232Z",
    "updatedAt": "2025-12-28T12:09:57.232Z"
  },
  "status": 1,
  "timestamp": "2025-12-28T12:09:57.232Z"
}

PreviousHow to get address books?NextHow to share address book?

Last updated 2 years ago