Get asset metadata for each vendor by contract address

get/api/assetpricing/v1/internal/assets/contract

Fetches real-time asset details from all available vendors for a given contract address and chain. Returns identifying information such as asset name, current price, market cap, genesis date, social media links, and descriptions. This data helps human reviewers verify asset mappings.

Returns empty vendor_results array if no data is available from any vendor.

Query Parameters

  • requestobjectRequired
    Contract address and chain for vendor asset lookup
    • contractAddressstringRequired
      Smart contract address
      Example: 0x1f...
      Pattern: ^[^;'"\\]+$
      Min length: >= 0 characters
      Max length: <= 200 characters
    • chainstringRequired
      Blockchain chain identifier (e.g. ethereum, solana)
      Example: ethereum
      Pattern: ^[a-zA-Z0-9-]+$
      Min length: >= 0 characters
      Max length: <= 100 characters

200 Response

contract_address string required
Contract address that was queried
Example: 0x1f..
chain string required
Blockchain chain that was queried
Example: ethereum
vendor_results array[object] required
Asset details from a specific vendor
vendor_id string required
Vendor identifier
Example: CoinGecko
vendor_asset_symbol string required
Vendor's asset symbol or identifier
Example: uniswap
name string
Asset name as reported by the vendor
Example: Uniswap
current_price_usd number <double>
Current price in USD as reported by the vendor
Example: 7.42
vendor_asset_metadata dictionary<string, object> required
Vendor-specific metadata including market cap, genesis date, links, description, and images. Structure varies by vendor.
Example: {"market_cap":5600000000,"genesis_date":"2020-09-17T00:00:00.000Z","links":{"homepage":"https://uniswap.org"}}
is_tracked boolean required
Whether this contract address is already mapped to a known asset in APS.
Example: true

400 Response

string

500 Response

string