Get an asset by its address
curl --request GET \
--url https://api.long.xyz/v1/assets/{assetAddress} \
--header 'X-API-KEY: <api-key>'{
"result": {
"asset_address": "<unknown>",
"asset_numeraire_address": "<unknown>",
"asset_creation_timestamp": "2023-11-07T05:31:56Z",
"asset_current_pool": "<string>",
"asset_migration_timestamp": "2023-11-07T05:31:56Z",
"auction_pool": {
"pool_current_price": "<string>",
"pool_current_sqrt_price": "<string>",
"pool_current_fdv": "<string>",
"pool_current_liquidity": "<string>",
"pool_current_tick": 123,
"pool_last_epoch": 123,
"pool_current_market_cap": "<string>",
"pool_current_fees_accrued": "<string>",
"pool_current_total_proceeds": "<string>",
"pool_current_total_tokens_sold": "<string>",
"pool_last_epoch_total_tokens_sold": "<string>",
"pool_current_sale_progress_percentage": 123,
"pool_config_max_proceeds": "<string>",
"pool_config_min_proceeds": "<string>",
"pool_config_num_tokens_to_sell": "<string>",
"pool_id": "<string>",
"pool_address": "<unknown>",
"pool_config_starting_time": "<string>",
"pool_config_ending_time": "<string>",
"pool_migration_timestamp": "2023-11-07T05:31:56Z",
"pool_type": "<string>",
"base_token": {
"token_address": "<unknown>",
"token_name": "<string>",
"token_description": "<string>",
"token_symbol": "<string>",
"token_decimals": 123,
"token_uri_data": {
"name": "<string>",
"description": "<string>",
"image_hash": "<string>",
"fee_receiver": "<string>",
"social_links": [
{
"label": "<string>",
"url": "<string>"
}
],
"vesting_recipients": [
{
"address": "<string>",
"amount": "<string>",
"percentage": "<string>"
}
]
},
"token_image_public_url": "<string>",
"token_creator_address": "<unknown>",
"token_fee_receiver_address": "<unknown>",
"token_vesting_recipient_addresses": [
"<unknown>"
]
}
},
"graduation_pool": {
"pool_current_price": "<string>",
"pool_current_sqrt_price": "<string>",
"pool_current_fdv": "<string>",
"pool_current_liquidity": "<string>",
"pool_current_tick": 123,
"pool_current_market_cap": "<string>",
"pool_address": "<unknown>",
"pool_migration_timestamp": "2023-11-07T05:31:56Z",
"pool_type": "<string>",
"base_token": {
"token_address": "<unknown>",
"token_name": "<string>",
"token_description": "<string>",
"token_symbol": "<string>",
"token_decimals": 123,
"token_uri_data": {
"name": "<string>",
"description": "<string>",
"image_hash": "<string>",
"fee_receiver": "<string>",
"social_links": [
{
"label": "<string>",
"url": "<string>"
}
],
"vesting_recipients": [
{
"address": "<string>",
"amount": "<string>",
"percentage": "<string>"
}
]
},
"token_image_public_url": "<string>",
"token_creator_address": "<unknown>",
"token_fee_receiver_address": "<unknown>",
"token_vesting_recipient_addresses": [
"<unknown>"
],
"integrator_address": "<string>"
}
},
"asset_status": "stall"
}
}API key for authentication
The chain ID of the asset to get
200
Show child attributes
Address — EVM address of the asset contract (newly created token in auction). This is the unique identifier for the token on the blockchain and can be used to interact with the token contract directly or add it to wallets.
Quote Token Address — EVM address of the numeraire (quote) token used for pricing this asset and directly paired with the asset in the auction.
Creation Timestamp — Date when the asset was initially created and deployed to the blockchain. Use this to calculate asset age or filter by creation date.
Current Pool - The current pool that the asset is in. Can be auction or graduation.
Migration Timestamp — Date when the asset was migrated from the auction pool to the graduation pool. Returns null if the asset hasn't migrated yet (still in auction phase) or auction ended unsuccessfully.
Auction Pool — Contains all current state and configuration for the active token auction. This pool uses a continuous Dutch auction Dynamic Bonding Curve mechanism where price adjusts based on demand.
Show child attributes
Price — Current token price in the numeraire (quote) token. Returned as a decimal string to preserve precision (e.g., "1.234567"). To display: multiply by your quote token decimals.
sqrtPriceX96 — Square root of price encoded as a Q64.96 fixed-point number. This is the internal price representation used by Uniswap V4/V3.
FDV — Fully Diluted Valuation in numeraire tokens. Calculated as total_supply * current_price.
Best metric for tracking asset market movement. Shows valuation in readable terms (e.g.,
$50kto$200kFDV) instead of long decimals for token price or ambiguous market cap.
liquidity — Swap depth currently in range (internal unit, not tokens/USD). Convert to token amounts with sqrtPriceX96 and tick bounds. Learn more
Tick — Current tick index in the Uniswap V3 price curve. Each tick represents a 0.01% price movement. Technical field primarily used for advanced integrations. Learn more
Epoch — Auction epoch number. Epochs are time periods (typically short periods 50-200 seconds) used to track auction progress. Increments each period.
Market Cap — Current market capitalization based on circulating supply in the numeraire token. Calculated as circulating_supply * current_price.
Fees Collected — Total trading fees collected by the auction pool since inception, denominated in the numeraire token.
Total Raised — Total amount raised from token sales in the numeraire token. This represents all accured numeraire tokens left in the acution after buy and sell transaction since the auction started.
Tokens Sold — Total number of tokens sold since auction start. Formatted as decimal string to preserve precision.
Tokens Sold (Last Epoch) — Number of tokens sold in the most recent completed epoch. Useful for tracking recent momentum and calculating velocity metrics.
Auction Progress — Percentage toward migration (0-100). Calculated as pool_current_total_proceeds / pool_config_max_proceeds * 100. When this hits 100, the auction migrates to graduation_pool.
Use case: Use as a progress bar or to trigger a UI state change indicating the pool is migrating.
Max Raise — Maximum amount that can be raised in numeraire tokens. Once reached, auction tradign is stooped and it will migarte to the graduation pool.
Min Raise — Minimum amount required to be raised for successful auction. If not met by pool_config_ending_time, the auction may be canceled and funds returned. Set for advanced integrations
Tokens for Sale — The total number of tokens being offered for sale in the auction. This value is fixed when the pool is created and represents the total inventory available for purchase.
Use case: Display to users the total size of the token offering, helping them gauge the scale of the auction. It's also used in calculations for initial pricing and token distribution upon completion.
Pool ID — The Unique Uniswap V4 pool identifier for this pool instance. Use this to track the pool across different endpoints or link to detailed pool pages.
Pool Address — EVM address of the pool smart contract. Use this to interact directly with the pool on-chain (e.g., for swaps, adding liquidity) or view in block explorers.
Starts At — Unix timestamp when the auction begins accepting trades (e.g., "1759330983"). Trades before this time will revert.
Ends At — Unix timestamp as string when the auction phase concludes (e.g., "1759352583"). After this, the pool may migrate if targets are met.
Migration Timestamp — Date when this pool migrated to the graduation pool. Returns null if still in active auction or if the auction ended unsuccessfully. Once migrated, this pool becomes read-only and trading moves to graduation_pool.
Pool Type — Uniswap protocol version used for this pool. Values: "v2", "v3", or "v4". Use this for trading routing, quote calculations, and protocol-specific integrations (e.g., concentrated liquidity on V3/V4).
Token Details — Complete metadata for the token being auctioned.
Note: This token metadata is duplicated in both
auction_poolandgraduation_poolfor convenience. It's the same token - use whichever pool you're working with.
Show child attributes
Token Address — EVM contract address of the token. Use this to add the token to wallets, verify on block explorers, or call the token contract directly.
Name — Full display name of the token (e.g., "Ethereum", "USD Coin"). Use this in UIs alongside the symbol.
Description — Project description or token purpose. Returns null if not provided by creator. Display in token detail pages.
Symbol — Short trading ticker (e.g., "ETH", "USDC"). Typically 2-5 uppercase characters. Use for compact displays and trading pairs.
**Decimals — The token's smallest unit (atomic unit). For example, with 18 decimals, 10^18 atomic units equal 1 token.
Metadata — Full token metadata from URI. Contains name, description, image_hash (IPFS), fee_receiver, social_links, and vesting_recipients (with address and amount for each). Returns null if not set.
Show child attributes
Logo URL — CDN-hosted image URL for the token logo (e.g., Google Cloud Storage). Optimized for fast loading. Use as <img src> in token displays.
Creator — EVM address that deployed and owns the token contract.
Fee Recipient — EVM address receiving trading fees and royalties. May differ from creator address. Fees are automatically sent here on each trade.
Vesting Recipients — Array of EVM addresses receiving vested tokens. Amounts are specified in token_uri_data.vesting_recipients with address and amount for each recipient. Tokens unlock gradually over time.
Graduation Pool — Secondary market trading pool that becomes active after the auction completes successfully. Built on Uniswap V3 for efficient, decentralized trading. Returns null values if auction hasn't graduated yet.
Show child attributes
Price — Current secondary market price in numeraire tokens. This is the post-graduation price determined by open market trading, not the auction mechanism.
sqrtPriceX96 — Technical price representation for Uniswap V3. Use pool_current_price for display purposes. Learn more
FDV — Fully Diluted Valuation in the graduation pool. Compare with auction pool's pool_current_fdv to track price movement after migration.
Liquidity — Total liquidity depth in the active price range. Higher liquidity means better prices for large trades.
Tick — Current tick index in the Uniswap V3/V4 price curve. See auction pool's pool_current_tick for details.
Market Cap — Post-graduation market cap based on circulating supply and current trading price. This reflects real market valuation.
Pool Address — EVM address of the Uniswap V3 pool contract for secondary trading. Use this address to execute swaps, add liquidity, or track on-chain activity.
Migration Timestamp — Date when the token graduated from auction to open market. Returns null if still in auction phase. Marks the transition to price-discovery trading.
Pool Type — Uniswap protocol version used for this graduation pool. Values: "v2", "v3", or "v4". Use this for trading routing, quote calculations, and protocol-specific integrations
Token Details — Complete metadata for the token in the graduation pool.
Note: Same token metadata as
auction_pool.base_token. Duplicated for convenience so you can access it from either pool.
Show child attributes
Token Address — EVM contract address of the token. Use this to add the token to wallets, verify on block explorers, or call the token contract directly.
Name — Full display name of the token (e.g., "Ethereum", "USD Coin"). Use this in UIs alongside the symbol.
Description — Project description or token purpose. Returns null if not provided by creator. Display in token detail pages.
Symbol — Short trading ticker (e.g., "ETH", "USDC"). Typically 2-5 uppercase characters. Use for compact displays and trading pairs.
**Decimals — The token's smallest unit (atomic unit). For example, with 18 decimals, 10^18 atomic units equal 1 token.
Metadata — Full token metadata from URI. Contains name, description, image_hash (IPFS), fee_receiver, social_links, and vesting_recipients (with address and amount for each). Returns null if not set.
Show child attributes
Logo URL — CDN-hosted image URL for the token logo. Optimized for fast loading. Use as <img src> in token displays.
Creator — EVM address that deployed the token contract. This address controls token settings and may receive creator fees.
Fee Recipient — EVM address receiving trading fees. May differ from creator address.
Vesting Recipients — Array of EVM addresses receiving vested tokens. Amounts are specified in token_uri_data.vesting_recipients with address and amount for each recipient.
Integrator — EVM address of the platform or protocol that integrated this token. May receive platform fees.
Asset Status — Live-computed status of the asset based on migration state and auction timing. Values: graduated (migrated to graduation pool), live (auction active), incoming (auction not started), stall (auction ended without migration).
graduated, live, incoming, stall curl --request GET \
--url https://api.long.xyz/v1/assets/{assetAddress} \
--header 'X-API-KEY: <api-key>'{
"result": {
"asset_address": "<unknown>",
"asset_numeraire_address": "<unknown>",
"asset_creation_timestamp": "2023-11-07T05:31:56Z",
"asset_current_pool": "<string>",
"asset_migration_timestamp": "2023-11-07T05:31:56Z",
"auction_pool": {
"pool_current_price": "<string>",
"pool_current_sqrt_price": "<string>",
"pool_current_fdv": "<string>",
"pool_current_liquidity": "<string>",
"pool_current_tick": 123,
"pool_last_epoch": 123,
"pool_current_market_cap": "<string>",
"pool_current_fees_accrued": "<string>",
"pool_current_total_proceeds": "<string>",
"pool_current_total_tokens_sold": "<string>",
"pool_last_epoch_total_tokens_sold": "<string>",
"pool_current_sale_progress_percentage": 123,
"pool_config_max_proceeds": "<string>",
"pool_config_min_proceeds": "<string>",
"pool_config_num_tokens_to_sell": "<string>",
"pool_id": "<string>",
"pool_address": "<unknown>",
"pool_config_starting_time": "<string>",
"pool_config_ending_time": "<string>",
"pool_migration_timestamp": "2023-11-07T05:31:56Z",
"pool_type": "<string>",
"base_token": {
"token_address": "<unknown>",
"token_name": "<string>",
"token_description": "<string>",
"token_symbol": "<string>",
"token_decimals": 123,
"token_uri_data": {
"name": "<string>",
"description": "<string>",
"image_hash": "<string>",
"fee_receiver": "<string>",
"social_links": [
{
"label": "<string>",
"url": "<string>"
}
],
"vesting_recipients": [
{
"address": "<string>",
"amount": "<string>",
"percentage": "<string>"
}
]
},
"token_image_public_url": "<string>",
"token_creator_address": "<unknown>",
"token_fee_receiver_address": "<unknown>",
"token_vesting_recipient_addresses": [
"<unknown>"
]
}
},
"graduation_pool": {
"pool_current_price": "<string>",
"pool_current_sqrt_price": "<string>",
"pool_current_fdv": "<string>",
"pool_current_liquidity": "<string>",
"pool_current_tick": 123,
"pool_current_market_cap": "<string>",
"pool_address": "<unknown>",
"pool_migration_timestamp": "2023-11-07T05:31:56Z",
"pool_type": "<string>",
"base_token": {
"token_address": "<unknown>",
"token_name": "<string>",
"token_description": "<string>",
"token_symbol": "<string>",
"token_decimals": 123,
"token_uri_data": {
"name": "<string>",
"description": "<string>",
"image_hash": "<string>",
"fee_receiver": "<string>",
"social_links": [
{
"label": "<string>",
"url": "<string>"
}
],
"vesting_recipients": [
{
"address": "<string>",
"amount": "<string>",
"percentage": "<string>"
}
]
},
"token_image_public_url": "<string>",
"token_creator_address": "<unknown>",
"token_fee_receiver_address": "<unknown>",
"token_vesting_recipient_addresses": [
"<unknown>"
],
"integrator_address": "<string>"
}
},
"asset_status": "stall"
}
}