---
title: "Fetch Asset Prices"
method: POST
path: "/api/v1/assets/prices"
tags: ["Assets"]
---

# Fetch Asset Prices

`POST /api/v1/assets/prices`

Fetch the prices of assets.

## Request body

- FetchAssetPricesRequest
  - `asset_identifiers` AssetIdentifierRequest[], required — The assets to price.
    - union
      - 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.
              - …
          - AptosNewCoinAssetIdentifierRequest
            - `type` 'new_coin', required — New coin asset identifier type.
            - `new_coin_type` AptosNewCoinTypeRequest, required — New coin type represents a blockchain new coin type.
              - …
      - 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.
              - …
      - 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).
              - …
      - 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.
              - …
          - EvmErc721AssetIdentifierRequest
            - `type` 'erc721', required — EVM asset identifier type.
            - `token` EvmAddressRequest, required — Address represents a blockchain address.
              - …
            - `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.
              - …
            - `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', 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.
              - …
      - 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.
              - …
      - 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
          - 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.
              - …
      - 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.
              - …
      - TonAssetIdentifierRequest
        - `type` 'ton', required — TON asset identifier type.
        - `details` union, required
          - TonNativeAssetIdentifierRequest
            - `type` 'native', required — TON asset identifier type.
            - `chain` 'ton_mainnet', required
          - TonJettonAssetIdentifierRequest
            - `type` 'jetton', required — Jetton asset identifier type.
            - `jetton` TonAddressRequest, required — Address represents a blockchain address.
              - …
      - 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.
              - …
      - 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

## Response `200`

Successful Response

- FetchAssetPricesResponse
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `priced_assets` PricedAssetResponse[], required — The priced assets.
    - union
      - PricedAsset
        - `type` 'asset_price', required
        - `asset_info` AssetInfo, required
          - `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
        - `price` Price — Price represents a price in a given FiatCurrency.
          - `price` string, required — The price in the given fiat currency.
          - `price_float` string, required — The absolute price in the given fiat currency. When is_negative is true the asset's value is the negative of this (e.g. a debt token).
          - `is_negative` boolean — Whether the asset's value is negative (e.g. a debt token). price_float holds the absolute value.
          - `fiat_currency` FiatCurrency, required
            - `currency_symbol` 'usd', required — FiatCurrencySymbol
            - `decimals` integer, required — The number of decimals in the fiat currency.
      - InvalidAssetRequest
        - `type` 'invalid_asset', required
        - `asset_identifier_request` union, required
          - AptosAssetIdentifierRequest
            - `type` 'aptos', required — Aptos asset identifier type.
            - `details` union, required
              - …
          - ArchAssetIdentifierRequest
            - `type` 'arch', required — Arch asset identifier type.
            - `details` union, required
              - …
          - CantonAssetIdentifierRequest
            - `type` 'canton', required — Canton asset identifier type.
            - `details` union, required
              - …
          - CosmosAssetIdentifierRequest
            - `type` 'cosmos', required — Cosmos asset identifier type.
            - `details` union, required
              - …
          - EvmAssetIdentifierRequest
            - `type` 'evm', required — Asset identifier type.
            - `details` union, required
              - …
          - ExchangeAssetIdentifierRequest
            - `type` 'exchange', required — Asset identifier type.
            - `exchange_type` 'binance' | 'bybit' | 'coinbase_international' | 'coinbase_us' | 'okx' | 'kraken', required
            - `asset_symbol` string, required — The symbol of the asset on the exchange.
          - SolanaAssetIdentifierRequest
            - `type` 'solana', required — Solana asset identifier type.
            - `details` union, required
              - …
          - StacksAssetIdentifierRequest
            - `type` 'stacks', required — Stacks asset identifier type.
            - `details` union, required
              - …
          - StellarAssetIdentifierRequest
            - `type` 'stellar', required — Stellar asset identifier type.
            - `details` union, required
              - …
          - StarknetAssetIdentifierRequest
            - `type` 'starknet', required — Starknet asset identifier type.
            - `details` union, required
              - …
          - SuiAssetIdentifierRequest
            - `type` 'sui', required — Sui asset identifier type.
            - `details` union, required
              - …
          - TonAssetIdentifierRequest
            - `type` 'ton', required — TON asset identifier type.
            - `details` union, required
              - …
          - TronAssetIdentifierRequest
            - `type` 'tron', required — TRON asset identifier type.
            - `details` union, required
              - …
          - UtxoAssetIdentifierRequest
            - `type` 'utxo', required — Utxo asset identifier type.
            - `details` UtxoNativeAssetIdentifierRequest, required
              - …
        - `error` string, required — The error message.

## 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/8014fd69ea17/schema)
