---
title: "Create Batch Contacts"
method: POST
path: "/api/v1/addressbook/contacts/batch"
tags: ["Address Book"]
---

# Create Batch Contacts

`POST /api/v1/addressbook/contacts/batch`

Create multiple new address book contacts in an organization.

## Headers

- `x-signature` string — Signature of the body. Base64 encoded string. If the request is made programatically by an API user, signing of the request is required and is intended to protect you from malicious backends. `x_signature` is valid for 120 seconds.
- `x-timestamp` integer — Timestamp of the signature. Integer. Specify an Epoch date. If the request is made programatically by an API user, the timestamp of the request is required and is intended to protect you from replay attacks.

## Request body

- CreateBatchContactsRequest
  - `contacts` CreateContactRequest[], required — The contacts to create.
    - union
      - CreateAptosContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'aptos', required — The type of the chain.
        - `address` string, required — The address on the Aptos chain.
        - `chains` AptosChainUniqueId[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` AptosAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'aptos', required — Aptos asset identifier type.
          - `details` union, required
            - AptosNativeAssetIdentifierRequest
              - …
            - AptosCoinAssetIdentifierRequest
              - …
            - AptosNewCoinAssetIdentifierRequest
              - …
      - CreateArchContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'arch', required — The type of the chain.
        - `address` string, required — The address on the arch chain.
        - `chains` ArchChainUniqueId[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` ArchAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'arch', required — Arch asset identifier type.
          - `details` union, required
            - ArchNativeAssetIdentifierRequest
              - …
            - ArchAplTokenAssetIdentifierRequest
              - …
      - CreateCantonContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'canton', required — The type of the chain.
        - `address` string, required — The party id on the Canton chain.
        - `chains` CantonChainUniqueId[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` CantonAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'canton', required — Canton asset identifier type.
          - `details` union, required
            - CantonNativeAssetIdentifierRequest
              - …
            - CantonCip56TokenAssetIdentifierRequest
              - …
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - CreateCosmosContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'cosmos', required — The type of the chain.
        - `address` string, required — The address on the cosmos chain in bech32 representation.
        - `chain` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required
        - `assets_identifiers` CosmosAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'cosmos', required — Cosmos asset identifier type.
          - `details` union, required
            - CosmosNativeAssetIdentifierRequest
              - …
            - CosmosTokenAssetIdentifierRequest
              - …
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - CreateEVMContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'evm', required — The type of the chain.
        - `address` string, required — The address of the contact.
        - `chains` string[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` EvmAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'evm', required — Asset identifier type.
          - `details` union, required
            - EvmNativeAssetIdentifierRequest
              - …
            - EvmErc20AssetIdentifierRequest
              - …
            - EvmErc721AssetIdentifierRequest
              - …
            - EvmErc1155AssetIdentifierRequest
              - …
            - EvmHyperLiquidAssetIdentifierRequest
              - …
      - CreateSolanaContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'solana', required — The type of the chain.
        - `address` string, required — The address on the solana chain.
        - `chains` SolanaChainUniqueId[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` SolanaAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'solana', required — Solana asset identifier type.
          - `details` union, required
            - SolanaNativeAssetIdentifierRequest
              - …
            - SolanaSplTokenAssetIdentifierRequest
              - …
      - CreateStacksContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'stacks', required — The type of the chain.
        - `address` string, required — The address on the Stacks chain.
        - `chains` StacksChainUniqueId[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` StacksAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'stacks', required — Stacks asset identifier type.
          - `details` union, required
            - StacksNativeAssetIdentifierRequest
              - …
            - StacksSip10AssetIdentifierRequest
              - …
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - CreateStarknetContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'starknet', required — The type of the chain.
        - `address` string, required — The address on the Starknet chain.
        - `chains` StarknetChainUniqueId[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` StarknetAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'starknet', required — Starknet asset identifier type.
          - `details` union, required
            - StarknetNativeAssetIdentifierRequest
              - …
            - StarknetErc20AssetIdentifierRequest
              - …
      - CreateStellarContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'stellar', required — The type of the chain.
        - `address` string, required — The address on the Stellar chain.
        - `chains` StellarChainUniqueId[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` StellarAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'stellar', required — Stellar asset identifier type.
          - `details` union, required
            - StellarNativeAssetIdentifierRequest
              - …
            - StellarClassicAssetIdentifierRequest
              - …
            - StellarSorobanAssetIdentifierRequest
              - …
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - CreateSuiContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'sui', required — The type of the chain.
        - `address` string, required — The address on the sui chain.
        - `chains` SuiChainUniqueId[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` SuiAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'sui', required — Sui asset identifier type.
          - `details` union, required
            - SuiNativeAssetIdentifierRequest
              - …
            - SuiCoinAssetIdentifierRequest
              - …
      - CreateTonContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'ton', required — The type of the chain.
        - `address` string, required — The address TON contract in any format.
        - `chains` TonChainUniqueId[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` TonAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'ton', required — TON asset identifier type.
          - `details` union, required
            - TonNativeAssetIdentifierRequest
              - …
            - TonJettonAssetIdentifierRequest
              - …
        - `comment` string — Comment is an additional address feature used for identifying a recipient.
      - CreateTronContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'tron', required — The type of the chain.
        - `address` string, required — The address on the TRON chain.
        - `chains` TronChainUniqueId[] — The chains the contact belongs to. If not provided, the contact will be associated with all chains.
        - `assets_identifiers` TronAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'tron', required — TRON asset identifier type.
          - `details` union, required
            - TronNativeAssetIdentifierRequest
              - …
            - TronTrc20AssetIdentifierRequest
              - …
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - CreateUtxoContactRequest
        - `name` string, required — The name of the contact.
        - `group_ids` string[] — The unique identifiers of the address groups.
        - `type` 'utxo', required — The type of the chain.
        - `address` string, required — The address on the utxo chain.
        - `chain` 'bitcoin_mainnet' | 'bitcoin_testnet' | 'bitcoin_testnet_v4' | 'dogecoin_mainnet' | 'bitcoin_cash_mainnet' | 'pearl_testnet' | 'pearl_mainnet', required
        - `assets_identifiers` UtxoAssetIdentifierRequest[] — The assets identifiers of the contact.
          - `type` 'utxo', required — Utxo asset identifier type.
          - `details` UtxoNativeAssetIdentifierRequest, required
            - `type` 'native', required — Utxo asset identifier type.
            - `chain` 'bitcoin_mainnet' | 'bitcoin_testnet' | 'bitcoin_testnet_v4' | 'dogecoin_mainnet' | 'bitcoin_cash_mainnet' | 'pearl_testnet' | 'pearl_mainnet', required

## Response `200`

Successful Response

- CreateBatchContactsResponse
  - `contacts` AddressBookContact[], required — The created contacts.
    - union — Represents a contact in the Fordefi platform
      - AptosAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'aptos', required — The type of the chain.
        - `address` string, required — The address on the aptos chain.
        - `chains` EnrichedAptosChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'aptos', required — The type of the chain.
          - `unique_id` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
      - ArchAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'arch', required — The type of the chain.
        - `address` string, required — The address on the Arch chain.
        - `chains` EnrichedArchChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'arch', required — The type of the chain.
          - `unique_id` 'arch_mainnet' | 'arch_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
      - CantonAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'canton', required — The type of the chain.
        - `address` string, required — The party id on the Canton chain.
        - `chains` EnrichedCantonChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'canton', required — The type of the chain.
          - `unique_id` 'canton_mainnet' | 'canton_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - CosmosAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'cosmos', required — The type of the chain.
        - `address` string, required — The address on the cosmos chain.
        - `chain` EnrichedCosmosChain, required
          - `chain_type` 'cosmos', required — The type of the chain.
          - `unique_id` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
          - `base_denom` string, required — The base denom of the chain.
          - `bech32_prefix` 'agoric' | 'akash' | 'archway' | 'axelar' | 'bbn' | 'celestia' | 'cosmos' | 'dydx' | 'dym' | 'inj' | 'neutron' | 'nillion' | 'noble' | 'osmo' | 'saga' | 'sei' | 'stride' | 'thor' | 'mantra', required
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - EVMAddressBookContact
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'evm', required — The type of the chain.
        - `address` string, required — TThe address of the contact.
        - `chains` EnrichedEvmChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'evm', required — The type of the chain.
          - `named_chain_id` string — The EVM chain name can be either one of those supported by the default chains below or a custom chain name if one was added to your organization. <ul><li>`arbitrum_mainnet`</li><li>`arbitrum_sepolia`</li><li>`aster_mainnet`</li><li>`avalanche_chain`</li><li>`avalanche_fuji`</li><li>`base_mainnet`</li><li>`berachain_mainnet`</li><li>`blast_mainnet`</li><li>`bsc_mainnet`</li><li>`canto_mainnet`</li><li>`clink_mainnet`</li><li>`clink_testnet`</li><li>`conflux_mainnet`</li><li>`dymension_mainnet`</li><li>`ethereum_goerli`</li><li>`ethereum_holesky`</li><li>`ethereum_mainnet`</li><li>`ethereum_sepolia`</li><li>`fantom_mainnet`</li><li>`flare_mainnet`</li><li>`flare_testnet`</li><li>`gnosis_mainnet`</li><li>`hypercore_mainnet`</li><li>`hyperevm_mainnet`</li><li>`ink_mainnet`</li><li>`kava_mainnet`</li><li>`katana_mainnet`</li><li>`linea_mainnet`</li><li>`optimism_mainnet`</li><li>`pharos_mainnet`</li><li>`plasma_mainnet`</li><li>`manta_pacific_mainnet`</li><li>`mantle_mainnet`</li><li>`merlin_mainnet`</li><li>`monad_mainnet`</li><li>`polygon_mainnet`</li><li>`polygon_mumbai`</li><li>`polygon_zkevm_mainnet`</li><li>`reya_mainnet`</li><li>`robinhood_mainnet`</li><li>`rootstock_mainnet`</li><li>`scroll_mainnet`</li><li>`sei_mainnet`</li><li>`sonic_mainnet`</li><li>`tempo_mainnet`</li><li>`unichain_mainnet`</li><li>`xai_mainnet`</li><li>`x_layer_mainnet`</li><li>`zero_gravity_mainnet`</li><li>`zeta_mainnet`</li><li>`zklink_nova_mainnet`</li><li>`zksync_era_mainnet`</li></ul>
          - `chain_id` integer, required — The EVM chain ID can be either one of those supported by the default chains below or a custom chain ID if one was added to your organization. <ul><li>1=`ethereum_mainnet`</li><li>5=`ethereum_goerli`</li><li>10=`optimism_mainnet`</li><li>14=`flare_mainnet`</li><li>16=`flare_testnet`</li><li>30=`rootstock_mainnet`</li><li>56=`bsc_mainnet`</li><li>100=`gnosis_mainnet`</li><li>130=`unichain_mainnet`</li><li>137=`polygon_mainnet`</li><li>143=`monad_mainnet`</li><li>146=`sonic_mainnet`</li><li>169=`manta_pacific_mainnet`</li><li>196=`x_layer_mainnet`</li><li>250=`fantom_mainnet`</li><li>324=`zksync_era_mainnet`</li><li>999=`hyperevm_mainnet`</li><li>1030=`conflux_mainnet`</li><li>1100=`dymension_mainnet`</li><li>1101=`polygon_zkevm_mainnet`</li><li>1329=`sei_mainnet`</li><li>1337=`hypercore_mainnet`</li><li>1666=`aster_mainnet`</li><li>1672=`pharos_mainnet`</li><li>1729=`reya_mainnet`</li><li>2222=`kava_mainnet`</li><li>4200=`merlin_mainnet`</li><li>4217=`tempo_mainnet`</li><li>4663=`robinhood_mainnet`</li><li>5000=`mantle_mainnet`</li><li>7000=`zeta_mainnet`</li><li>7700=`canto_mainnet`</li><li>8453=`base_mainnet`</li><li>8818=`clink_mainnet`</li><li>8819=`clink_testnet`</li><li>9745=`plasma_mainnet`</li><li>16661=`zero_gravity_mainnet`</li><li>17000=`ethereum_holesky`</li><li>80001=`polygon_mumbai`</li><li>80094=`berachain_mainnet`</li><li>42161=`arbitrum_mainnet`</li><li>43113=`avalanche_fuji`</li><li>43114=`avalanche_chain`</li><li>57073=`ink_mainnet`</li><li>59144=`linea_mainnet`</li><li>81457=`blast_mainnet`</li><li>421614=`arbitrum_sepolia`</li><li>534352=`scroll_mainnet`</li><li>660279=`xai_mainnet`</li><li>747474=`katana_mainnet`</li><li>810180=`zklink_nova_mainnet`</li><li>11155111=`ethereum_sepolia`</li></ul>
          - `unique_id` string, required — The unique EVM chain ID. </br>Can be either one of those supported by the default chains below or a custom numeric chain ID `evm_<numeric_chain_id>` if one was added to your organization. <ul><li>`"evm_1"`</li><li>`"evm_5"`</li><li>`"evm_10"`</li><li>`"evm_14"`</li><li>`"evm_16"`</li><li>`"evm_30"`</li><li>`"evm_56"`</li><li>`"evm_100"`</li><li>`"evm_130"`</li><li>`"evm_137"`</li><li>`"evm_143"`</li><li>`"evm_146"`</li><li>`"evm_169"`</li><li>`"evm_196"`</li><li>`"evm_250"`</li><li>`"evm_324"`</li><li>`"evm_999"`</li><li>`"evm_1030"`</li><li>`"evm_1100"`</li><li>`"evm_1101"`</li><li>`"evm_1329"`</li><li>`"evm_1337"`</li><li>`"evm_1666"`</li><li>`"evm_1672"`</li><li>`"evm_1729"`</li><li>`"evm_2222"`</li><li>`"evm_4200"`</li><li>`"evm_4217"`</li><li>`"evm_4663"`</li><li>`"evm_5000"`</li><li>`"evm_7000"`</li><li>`"evm_7700"`</li><li>`"evm_8453"`</li><li>`"evm_8818"`</li><li>`"evm_8819"`</li><li>`"evm_9745"`</li><li>`"evm_16661"`</li><li>`"evm_17000"`</li><li>`"evm_80001"`</li><li>`"evm_80094"`</li><li>`"evm_42161"`</li><li>`"evm_43113"`</li><li>`"evm_43114"`</li><li>`"evm_57073"`</li><li>`"evm_59144"`</li><li>`"evm_81457"`</li><li>`"evm_421614"`</li><li>`"evm_534352"`</li><li>`"evm_660279"`</li><li>`"evm_747474"`</li><li>`"evm_810180"`</li><li>`"evm_11155111"`</li><li>`"evm_ethereum_mainnet"`</li><li>`"evm_ethereum_goerli"`</li><li>`"evm_optimism_mainnet"`</li><li>`"evm_flare_mainnet"`</li><li>`"evm_flare_testnet"`</li><li>`"evm_rootstock_mainnet"`</li><li>`"evm_bsc_mainnet"`</li><li>`"evm_gnosis_mainnet"`</li><li>`"evm_unichain_mainnet"`</li><li>`"evm_polygon_mainnet"`</li><li>`"evm_monad_mainnet"`</li><li>`"evm_sonic_mainnet"`</li><li>`"evm_manta_pacific_mainnet"`</li><li>`"evm_x_layer_mainnet"`</li><li>`"evm_fantom_mainnet"`</li><li>`"evm_zksync_era_mainnet"`</li><li>`"evm_hyperevm_mainnet"`</li><li>`"evm_conflux_mainnet"`</li><li>`"evm_dymension_mainnet"`</li><li>`"evm_polygon_zkevm_mainnet"`</li><li>`"evm_sei_mainnet"`</li><li>`"evm_hypercore_mainnet"`</li><li>`"evm_aster_mainnet"`</li><li>`"evm_pharos_mainnet"`</li><li>`"evm_reya_mainnet"`</li><li>`"evm_kava_mainnet"`</li><li>`"evm_merlin_mainnet"`</li><li>`"evm_tempo_mainnet"`</li><li>`"evm_robinhood_mainnet"`</li><li>`"evm_mantle_mainnet"`</li><li>`"evm_zeta_mainnet"`</li><li>`"evm_canto_mainnet"`</li><li>`"evm_base_mainnet"`</li><li>`"evm_clink_mainnet"`</li><li>`"evm_clink_testnet"`</li><li>`"evm_plasma_mainnet"`</li><li>`"evm_zero_gravity_mainnet"`</li><li>`"evm_ethereum_holesky"`</li><li>`"evm_polygon_mumbai"`</li><li>`"evm_berachain_mainnet"`</li><li>`"evm_arbitrum_mainnet"`</li><li>`"evm_avalanche_fuji"`</li><li>`"evm_avalanche_chain"`</li><li>`"evm_ink_mainnet"`</li><li>`"evm_linea_mainnet"`</li><li>`"evm_blast_mainnet"`</li><li>`"evm_arbitrum_sepolia"`</li><li>`"evm_scroll_mainnet"`</li><li>`"evm_xai_mainnet"`</li><li>`"evm_katana_mainnet"`</li><li>`"evm_zklink_nova_mainnet"`</li><li>`"evm_ethereum_sepolia"`</li></ul>
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
          - `gas_type` 'dynamic' | 'legacy', required
          - `supports_secure_node` boolean — `True` if the chain supports secure nodes, `False` otherwise.
          - `supports_mev_protected_node` boolean — `True` if the chain supports MEV protected nodes, `False` otherwise.
          - `rpc_url` string — The URL of the chain's RPC. Exists only for custom chains.
          - `source` 'default' | 'custom', required
          - `supports_7702` boolean — `True` if the chain supports 7702, `False` otherwise.
      - SolanaAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'solana', required — The type of the chain.
        - `address` string, required — The address on the solana chain.
        - `chains` EnrichedSolanaChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'solana', required — The type of the chain.
          - `unique_id` 'solana_mainnet' | 'solana_devnet' | 'solana_eclipse_mainnet' | 'solana_fogo_mainnet' | 'solana_fogo_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
      - StacksAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'stacks', required — The type of the chain.
        - `address` string, required — The address on the stacks chain.
        - `chains` EnrichedStacksChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'stacks', required — The type of the chain.
          - `unique_id` 'stacks_mainnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - StarknetAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'starknet', required — The type of the chain.
        - `address` string, required — The address on the starknet chain.
        - `chains` EnrichedStarknetChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'starknet', required — The type of the chain.
          - `unique_id` 'starknet_mainnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
      - StellarAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'stellar', required — The type of the chain.
        - `address` string, required — The address on the Stellar chain.
        - `chains` EnrichedStellarChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'stellar', required — The type of the chain.
          - `unique_id` 'stellar_mainnet' | 'stellar_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - SuiAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'sui', required — The type of the chain.
        - `address` string, required — The address on the sui chain.
        - `chains` EnrichedSuiChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'sui', required — The type of the chain.
          - `unique_id` 'sui_mainnet' | 'sui_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
      - TonAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'ton', required — The type of the chain.
        - `address` string, required — The address on the TON chain.
        - `chains` EnrichedTonChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'ton', required — The type of the chain.
          - `unique_id` 'ton_mainnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
        - `comment` string — Comment is an additional address feature used for identifying a recipient.
      - TronAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'tron', required — The type of the chain.
        - `address` string, required — The address on the TRON chain.
        - `chains` EnrichedTronChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'tron', required — The type of the chain.
          - `unique_id` 'tron_mainnet' | 'tron_shasta', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - UtxoAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'utxo', required — The type of the chain.
        - `address` string, required — The address on the utxo chain.
        - `chain` EnrichedUtxoChain, required
          - `chain_type` 'utxo', required — The type of the chain.
          - `unique_id` 'bitcoin_mainnet' | 'bitcoin_testnet' | 'bitcoin_testnet_v4' | 'dogecoin_mainnet' | 'bitcoin_cash_mainnet' | 'pearl_testnet' | 'pearl_mainnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized User
- `403` — Forbidden User
- `408` — Request Timeout
- `422` — Validation Error
- `429` — Rate Limit Exceeded
- `500` — Unexpected Error

---

[API](https://skmtc.net/fordefi/apis/fordefi-api.md) · [All operations](https://skmtc.net/fordefi/apis/fordefi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fordefi/fordefi-api/revisions/8014fd69ea17/schema)