---
title: "Update Asset Configuration"
method: PUT
path: "/api/v1/assets"
tags: ["Assets"]
---

# Update Asset Configuration

`PUT /api/v1/assets`

Update the asset's configuration under the entire organization.

## Request body

- UpdateAssetConfiguration
  - `asset` union, required
    - AptosAssetIdentifierRequest
      - `type` 'aptos', required — Aptos asset identifier type.
      - `details` union, required
        - AptosNativeAssetIdentifierRequest
          - `type` 'native', required — Aptos asset identifier type.
          - `chain` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required
        - AptosCoinAssetIdentifierRequest
          - `type` 'coin', required — Legacy coin asset identifier type.
          - `coin_type` AptosCoinTypeRequest, required — Coin type represents a blockchain legacy coin type.
            - `chain` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required
            - `coin_type_str` string, required — Coin type string representation.
        - AptosNewCoinAssetIdentifierRequest
          - `type` 'new_coin', required — New coin asset identifier type.
          - `new_coin_type` AptosNewCoinTypeRequest, required — New coin type represents a blockchain new coin type.
            - `chain` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required
            - `metadata_address` string, required — New coin's metadata address.
    - ArchAssetIdentifierRequest
      - `type` 'arch', required — Arch asset identifier type.
      - `details` union, required
        - ArchNativeAssetIdentifierRequest
          - `type` 'native', required — Arch asset identifier type.
          - `chain` 'arch_mainnet' | 'arch_testnet', required
        - ArchAplTokenAssetIdentifierRequest
          - `type` 'apl_token', required — APL token asset identifier type.
          - `token` ArchAddressRequest, required — Address represents a blockchain address.
            - `chain` 'arch_mainnet' | 'arch_testnet', required
            - `base58_repr` string, required — Base58 representation of the address in the chain.
    - CantonAssetIdentifierRequest
      - `type` 'canton', required — Canton asset identifier type.
      - `details` union, required
        - CantonNativeAssetIdentifierRequest
          - `type` 'native', required — Canton asset identifier type.
          - `chain` 'canton_mainnet' | 'canton_testnet', required
        - CantonCip56TokenAssetIdentifierRequest
          - `type` 'cip56_token', required — CIP56 token asset identifier type.
          - `token` CantonInstrumentIdRequest, required — Instrument ID represents a Canton instrument identifier (address + id).
            - `address` CantonAddressRequest, required — Address represents a blockchain address.
              - …
            - `id` string, required — The instrument ID within the provider's namespace.
    - CosmosAssetIdentifierRequest
      - `type` 'cosmos', required — Cosmos asset identifier type.
      - `details` union, required
        - CosmosNativeAssetIdentifierRequest
          - `type` 'native', required — Cosmos asset identifier type.
          - `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
        - CosmosTokenAssetIdentifierRequest
          - `type` 'token', required — Token asset identifier type.
          - `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
          - `denom` string, required — The denom of the asset.
    - EvmAssetIdentifierRequest
      - `type` 'evm', required — Asset identifier type.
      - `details` union, required
        - EvmNativeAssetIdentifierRequest
          - `type` 'native', required — EVM asset identifier type.
          - `chain` string, required — The details of the chain of the native asset.
        - EvmErc20AssetIdentifierRequest
          - `type` 'erc20', required — EVM asset identifier type.
          - `token` EvmAddressRequest, required — Address represents a blockchain address.
            - `chain` string, required — The chain details this address is of.
            - `hex_repr` string, required — Hexadecimal representation of the address in the chain.
        - EvmErc721AssetIdentifierRequest
          - `type` 'erc721', required — EVM asset identifier type.
          - `token` EvmAddressRequest, required — Address represents a blockchain address.
            - `chain` string, required — The chain details this address is of.
            - `hex_repr` string, required — Hexadecimal representation of the address in the chain.
          - `token_id` string, required — The token id of the ERC-721 token.
        - EvmErc1155AssetIdentifierRequest
          - `type` 'erc1155', required — EVM asset identifier type.
          - `token` EvmAddressRequest, required — Address represents a blockchain address.
            - `chain` string, required — The chain details this address is of.
            - `hex_repr` string, required — Hexadecimal representation of the address in the chain.
          - `token_id` string, required — The token id of the ERC-1155 token.
        - EvmHyperLiquidAssetIdentifierRequest
          - `type` 'hyperliquid', required — EVM asset identifier type.
          - `chain` string, required — Currently artificially set to Arbitrum.
          - `token_id` string, required — The token id of the asset on Hyperliquid.
          - `index` integer, required — The index of the asset on Hyperliquid.
    - ExchangeAssetIdentifierRequest
      - `type` 'exchange', required — Asset identifier type.
      - `exchange_type` 'binance' | 'bybit' | 'coinbase_international' | 'coinbase_us' | 'okx' | 'kraken' | 'paxos', required
      - `asset_symbol` string, required — The symbol of the asset on the exchange.
    - SolanaAssetIdentifierRequest
      - `type` 'solana', required — Solana asset identifier type.
      - `details` union, required
        - SolanaNativeAssetIdentifierRequest
          - `type` 'native', required — Solana asset identifier type.
          - `chain` 'solana_mainnet' | 'solana_devnet' | 'solana_eclipse_mainnet' | 'solana_fogo_mainnet' | 'solana_fogo_testnet', required
        - SolanaSplTokenAssetIdentifierRequest
          - `type` 'spl_token', required — SPL token asset identifier type.
          - `token` SolanaAddressRequest, required — Address represents a blockchain address.
            - `chain` 'solana_mainnet' | 'solana_devnet' | 'solana_eclipse_mainnet' | 'solana_fogo_mainnet' | 'solana_fogo_testnet', required
            - `base58_repr` string, required — Base58 representation of the address in the chain.
    - StacksAssetIdentifierRequest
      - `type` 'stacks', required — Stacks asset identifier type.
      - `details` union, required
        - StacksNativeAssetIdentifierRequest
          - `type` 'native', required — Stacks asset identifier type.
          - `chain` 'stacks_mainnet', required
        - StacksSip10AssetIdentifierRequest
          - `type` 'sip10', required — Sip10 asset identifier type.
          - `sip10` StacksAddressRequest, required — Address represents a blockchain address.
            - `chain` 'stacks_mainnet', required
            - `hex_repr` string, required — Hexadecimal representation of the address in the chain.
    - StellarAssetIdentifierRequest
      - `type` 'stellar', required — Stellar asset identifier type.
      - `details` union, required
        - StellarNativeAssetIdentifierRequest
          - `type` 'native', required — Stellar asset identifier type.
          - `chain` 'stellar_mainnet' | 'stellar_testnet', required
        - StellarClassicAssetIdentifierRequest
          - `type` 'classic_asset', required — Stellar asset identifier type.
          - `code` string, required — The 1-4 character asset code.
          - `issuer` StellarAddressRequest, required — Address represents a blockchain address.
            - `chain` 'stellar_mainnet' | 'stellar_testnet', required
            - `base32_repr` string, required — Hexadecimal representation of the address in the chain.
          - `chain` 'stellar_mainnet' | 'stellar_testnet', required
        - StellarSorobanAssetIdentifierRequest
          - `type` 'soroban_asset', required — Stellar asset identifier type.
          - `address` string, required — The Soroban asset address.
          - `chain` 'stellar_mainnet' | 'stellar_testnet', required
    - StarknetAssetIdentifierRequest
      - `type` 'starknet', required — Starknet asset identifier type.
      - `details` union, required
        - StarknetNativeAssetIdentifierRequest
          - `type` 'native', required — Starknet asset identifier type.
          - `chain` 'starknet_mainnet', required
        - StarknetErc20AssetIdentifierRequest
          - `type` 'erc20', required — Erc20 asset identifier type.
          - `erc20` StarknetAddressRequest, required — Address represents a blockchain address.
            - `chain` 'starknet_mainnet', required
            - `hex_repr` string, required — Hexadecimal representation of the address in the chain.
    - SuiAssetIdentifierRequest
      - `type` 'sui', required — Sui asset identifier type.
      - `details` union, required
        - SuiNativeAssetIdentifierRequest
          - `type` 'native', required — Sui asset identifier type.
          - `chain` 'sui_mainnet' | 'sui_testnet', required
        - SuiCoinAssetIdentifierRequest
          - `type` 'coin', required — Coin asset identifier type.
          - `coin_type` SuiCoinTypeRequest, required — Coin type represents a blockchain coin type.
            - `chain` 'sui_mainnet' | 'sui_testnet', required
            - `coin_type_str` string, required — Coin type string representation.
    - TonAssetIdentifierRequest
      - `type` 'ton', required — TON asset identifier type.
      - `details` union, required
        - TonNativeAssetIdentifierRequest
          - `type` 'native', required — TON asset identifier type.
          - `chain` 'ton_mainnet' | 'ton_testnet', required
        - TonJettonAssetIdentifierRequest
          - `type` 'jetton', required — Jetton asset identifier type.
          - `jetton` TonAddressRequest, required — Address represents a blockchain address.
            - `chain` 'ton_mainnet' | 'ton_testnet', required
            - `address` string, required — Contract address in a raw format.
    - TronAssetIdentifierRequest
      - `type` 'tron', required — TRON asset identifier type.
      - `details` union, required
        - TronNativeAssetIdentifierRequest
          - `type` 'native', required — TRON asset identifier type.
          - `chain` 'tron_mainnet' | 'tron_shasta', required
        - TronTrc20AssetIdentifierRequest
          - `type` 'trc20', required — Trc20 asset identifier type.
          - `trc20` TronAddressRequest, required — Address represents a blockchain address.
            - `chain` 'tron_mainnet' | 'tron_shasta', required
            - `base58_repr` string, required — Base58 representation of the address in the chain.
    - UtxoAssetIdentifierRequest
      - `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
  - `hidden` boolean, required — `True` to hide the token when listing assets, `False` otherwise.

## Response `204`

Successful Response

## 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/versions/c4c28d233105/schema)