{"components":{"schemas":{"AffiliateAccount":{"properties":{"account_fee":{"description":"Account fee","format":"int32","type":"integer"},"account_id":{"description":"Account ID","type":"string"},"account_id_hash":{"description":"Hash of the account ID","type":"string"},"account_type":{"description":"Type of affiliate account","type":"string"},"address":{"description":"Affiliate account address","type":"string"},"balance_claimed":{"$ref":"#/components/schemas/LargeInteger"},"balance_for_claim":{"$ref":"#/components/schemas/LargeInteger"},"controller_address":{"description":"Controller address","type":"string"},"initialized":{"description":"Whether the account is initialized","type":"boolean"},"program_address":{"description":"Program address","type":"string"}},"required":["address","initialized","program_address","account_type","account_id","account_id_hash","account_fee","controller_address","balance_for_claim","balance_claimed"],"type":"object"},"AffiliateAccountReferrer":{"properties":{"account_fee":{"description":"Account fee of the affiliate account","format":"int32","type":"integer"},"account_id":{"description":"Account ID of the affiliate account that referred this wallet","type":"string"}},"required":["account_id","account_fee"],"type":"object"},"AffiliateAccountVolume":{"properties":{"account_id":{"description":"Affiliate account ID","type":"string"},"affiliate_account_address":{"description":"Unique affiliate account address","type":"string"},"controller_address":{"description":"Controller address that initiated trades","type":"string"},"referral_volumes":{"description":"Trading volume breakdown per referral wallet","items":{"$ref":"#/components/schemas/AffiliateReferralVolume"},"type":"array"},"referrals_total_volume":{"$ref":"#/components/schemas/AffiliateVolumeBreakdown"}},"required":["affiliate_account_address","account_id","controller_address","referrals_total_volume","referral_volumes"],"type":"object"},"AffiliateAccountVolumeResponse":{"properties":{"accounts":{"description":"List of affiliate accounts with referral trading volumes","items":{"$ref":"#/components/schemas/AffiliateAccountVolume"},"type":"array"},"wallet_volume":{"$ref":"#/components/schemas/AffiliateWalletVolume"}},"required":["accounts"],"type":"object"},"AffiliateReferralVolume":{"properties":{"volume":{"$ref":"#/components/schemas/AffiliateVolumeBreakdown"},"wallet_address":{"description":"Wallet address of the referral","type":"string"}},"required":["wallet_address","volume"],"type":"object"},"AffiliateReferralsResponse":{"properties":{"referrals":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"description":"Mapping of affiliate account IDs to the list of referred wallet addresses","type":"object"},"total_count":{"description":"Total number of referred wallet addresses across all accounts","format":"int32","type":"integer"}},"required":["referrals","total_count"],"type":"object"},"AffiliateVolumeBreakdown":{"properties":{"volume_in_ton":{"$ref":"#/components/schemas/LargeFloat"},"volume_in_usd":{"$ref":"#/components/schemas/LargeFloat"}},"required":["volume_in_ton","volume_in_usd"],"type":"object"},"AffiliateWalletVolume":{"properties":{"transactions":{"description":"Number of buy transactions contributing to the volume","format":"int64","type":"integer"},"volume":{"$ref":"#/components/schemas/AffiliateVolumeBreakdown"},"wallet_address":{"description":"Wallet address for which the volume is reported","type":"string"}},"required":["wallet_address","volume","transactions"],"type":"object"},"ChartByPoolAddressResponse":{"properties":{"hlocv":{"items":{"$ref":"#/components/schemas/HLOCV"},"type":"array"},"opposite_asset_hlocv":{"items":{"$ref":"#/components/schemas/HLOCV"},"type":"array"}},"required":["hlocv","opposite_asset_hlocv"],"type":"object"},"ChartResponse":{"properties":{"opposite_asset_hlocv":{"items":{"$ref":"#/components/schemas/HLOCV"},"type":"array"},"ton_hlocv":{"items":{"$ref":"#/components/schemas/HLOCV"},"type":"array"},"usd_hlocv":{"items":{"$ref":"#/components/schemas/HLOCV"},"type":"array"}},"required":["ton_hlocv","usd_hlocv","opposite_asset_hlocv"],"type":"object"},"Coin":{"properties":{"asset":{"description":"Abstraction over asset types (native or jetton:0:\u003caddress\u003e)","type":"string"},"ath_date":{"description":"Date of the all-time high","format":"date-time","type":"string"},"ath_market_cap_usd":{"$ref":"#/components/schemas/LargeFloat"},"ath_usd":{"$ref":"#/components/schemas/LargeFloat"},"atl_date":{"description":"Date of the all-time low","format":"date-time","type":"string"},"atl_market_cap_usd":{"$ref":"#/components/schemas/LargeFloat"},"atl_usd":{"$ref":"#/components/schemas/LargeFloat"},"buy_tax":{"description":"Tax applied on buy transactions in percent (0-100)","format":"int32","maximum":100,"minimum":0,"type":"integer"},"circulating_supply":{"$ref":"#/components/schemas/LargeInteger"},"created_at":{"description":"Timestamp when the token was created","format":"date-time","type":"string"},"extra_details":{"$ref":"#/components/schemas/CoinExtraDetails"},"fully_diluted_market_cap":{"$ref":"#/components/schemas/LargeFloat"},"holders":{"description":"Number of holders","format":"int64","type":"integer"},"liquidity":{"$ref":"#/components/schemas/LargeFloat"},"market_cap":{"$ref":"#/components/schemas/LargeFloat"},"memecoin_extra_details":{"$ref":"#/components/schemas/MemeCoinExtraDetails"},"metadata":{"$ref":"#/components/schemas/CoinMetadata"},"price":{"$ref":"#/components/schemas/PriceInfo"},"sell_tax":{"description":"Tax applied on sell transactions in percent (0-100)","format":"int32","maximum":100,"minimum":0,"type":"integer"},"tags":{"description":"List of tags associated with the token (Like \"tonfun\", \"LP\", etc.)","items":{"type":"string"},"type":"array"},"total_supply":{"$ref":"#/components/schemas/LargeInteger"},"traders":{"$ref":"#/components/schemas/TradersInfo"},"transactions":{"$ref":"#/components/schemas/TransactionsInfo"},"verification_level":{"description":"Verification level of the token (0-4)","format":"int32","type":"integer"},"volume":{"$ref":"#/components/schemas/VolumeInfo"}},"required":["asset","metadata"],"type":"object"},"CoinExtraDetails":{"properties":{"30d_high":{"$ref":"#/components/schemas/LargeFloat"},"30d_low":{"$ref":"#/components/schemas/LargeFloat"},"7d_high":{"$ref":"#/components/schemas/LargeFloat"},"7d_low":{"$ref":"#/components/schemas/LargeFloat"},"liquidity_pools":{"description":"List of liquidity pools containing this token","items":{"$ref":"#/components/schemas/LiquidityPool"},"type":"array"}},"type":"object"},"CoinMetadata":{"properties":{"decimals":{"description":"Decimals for the token","format":"int32","type":"integer"},"description":{"description":"Description of the token","type":"string"},"image_url":{"description":"URL of the token image","format":"url","type":"string"},"name":{"description":"Name of the token","type":"string"},"social_links":{"additionalProperties":{"type":"string"},"description":"Social links associated with the token (e.g., website, X, Telegram)","type":"object"},"ticker":{"description":"Ticker symbol of the token","type":"string"},"usd_price":{"$ref":"#/components/schemas/LargeFloat"}},"required":["name","ticker","decimals"],"type":"object"},"CoinTransaction":{"properties":{"platform":{"description":"DEX platform name","enum":["dedust","dedust_v3","dedust_v3_memepad","stonfi","tonco","tonfun","bidask"],"type":"string"},"pool_address":{"description":"Address of the pool where the transaction occurred","type":"string"},"pool_type":{"description":"Type of the pool","enum":["dedust","stonfi_v1","stonfi_v2","bidask","blum","tonfun","dedust_v3_cpmm","dedust_v3_memepad"],"type":"string"},"price_ton":{"$ref":"#/components/schemas/LargeFloat"},"price_usd":{"$ref":"#/components/schemas/LargeFloat"},"trade_asset_in":{"description":"Abstraction over asset types (native or jetton:0:\u003caddress\u003e)","type":"string"},"trade_asset_in_amount":{"$ref":"#/components/schemas/LargeInteger"},"trade_asset_in_decimals":{"description":"Decimals of the asset that was traded in","format":"int32","type":"integer"},"trade_asset_in_ticker":{"description":"Ticker of the asset that was traded in","type":"string"},"trade_asset_out":{"description":"Abstraction over asset types (native or jetton:0:\u003caddress\u003e)","type":"string"},"trade_asset_out_amount":{"$ref":"#/components/schemas/LargeInteger"},"trade_asset_out_decimals":{"description":"Decimals of the asset that was traded out","format":"int32","type":"integer"},"trade_asset_out_ticker":{"description":"Ticker of the asset that was traded out","type":"string"},"trade_date":{"description":"Date and time of the transaction","format":"date-time","type":"string"},"trader_address":{"description":"Address of the trader who made the transaction","type":"string"},"tx_hash":{"description":"Transaction hash of the trade","type":"string"},"type":{"description":"Type of the transaction","enum":["buy","sell"],"type":"string"},"volume_ton":{"$ref":"#/components/schemas/LargeFloat"},"volume_usd":{"$ref":"#/components/schemas/LargeFloat"}},"required":["trade_date","pool_address","pool_type","trade_asset_in","trade_asset_out","trade_asset_in_amount","trade_asset_out_amount","trade_asset_in_ticker","trade_asset_out_ticker","trade_asset_in_decimals","trade_asset_out_decimals","type","price_usd","price_ton","volume_usd","volume_ton","trader_address","platform"],"type":"object"},"CoinTransactionsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CoinTransaction"},"type":"array"}},"required":["items"],"type":"object"},"CoinsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/Coin"},"type":"array"},"total_count":{"description":"Total number of coins available (omitted when skip_total_count=true)","format":"int64","nullable":true,"type":"integer"}},"required":["items"],"type":"object"},"Deposit":{"properties":{"added_at":{"description":"Timestamp when the deposit was added","format":"date-time","type":"string"},"amount_x":{"$ref":"#/components/schemas/LargeInteger"},"amount_y":{"$ref":"#/components/schemas/LargeInteger"},"deposit_address":{"description":"Address of the deposit contract","type":"string"},"initiator_address":{"description":"Address of the user who initiated the deposit","type":"string"},"mc_seq_no":{"description":"Masterchain sequence number","format":"int32","type":"integer"},"minimal_liquidity":{"$ref":"#/components/schemas/LargeInteger"},"pool_address":{"description":"Address of the pool","type":"string"}},"required":["deposit_address","pool_address","initiator_address","amount_x","amount_y","minimal_liquidity","added_at","mc_seq_no"],"type":"object"},"DepositsResponse":{"properties":{"deposits":{"description":"List of deposits","items":{"$ref":"#/components/schemas/Deposit"},"type":"array"},"total_count":{"description":"Total number of deposits","format":"int32","type":"integer"}},"required":["deposits","total_count"],"type":"object"},"DexscreenerAsset":{"properties":{"circulatingSupply":{"$ref":"#/components/schemas/LargeFloat"},"coinGeckoId":{"description":"CoinGecko ID","type":"string"},"coinMarketCapId":{"description":"CoinMarketCap ID","type":"string"},"id":{"description":"Asset ID (case-sensitive)","type":"string"},"metadata":{"additionalProperties":{"type":"string"},"description":"Optional metadata","type":"object"},"name":{"description":"Asset name","type":"string"},"symbol":{"description":"Asset symbol","type":"string"},"totalSupply":{"$ref":"#/components/schemas/LargeFloat"}},"required":["id","name","symbol"],"type":"object"},"DexscreenerAssetResponse":{"properties":{"asset":{"$ref":"#/components/schemas/DexscreenerAsset"}},"required":["asset"],"type":"object"},"DexscreenerBlock":{"properties":{"blockNumber":{"description":"Block number","format":"int64","type":"integer"},"blockTimestamp":{"description":"UNIX timestamp (no milliseconds)","format":"int64","type":"integer"},"metadata":{"additionalProperties":{"type":"string"},"description":"Optional metadata","type":"object"}},"required":["blockNumber","blockTimestamp"],"type":"object"},"DexscreenerEvent":{"properties":{"amount0":{"$ref":"#/components/schemas/LargeFloat"},"amount1":{"$ref":"#/components/schemas/LargeFloat"},"asset0In":{"$ref":"#/components/schemas/LargeFloat"},"asset0Out":{"$ref":"#/components/schemas/LargeFloat"},"asset1In":{"$ref":"#/components/schemas/LargeFloat"},"asset1Out":{"$ref":"#/components/schemas/LargeFloat"},"block":{"$ref":"#/components/schemas/DexscreenerBlock"},"eventIndex":{"description":"Event index within transaction","format":"int32","type":"integer"},"eventType":{"description":"Type of event","enum":["swap","join","exit"],"type":"string"},"maker":{"description":"Address of transaction maker","type":"string"},"metadata":{"additionalProperties":true,"description":"Optional metadata. For memepad events, includes:\n- progress: Bonding curve progress as a percentage float (e.g., 52.50), calculated as (raised_funds / (raising_funds + migration_fee)) * 100","type":"object"},"pairId":{"description":"Pair ID","type":"string"},"priceNative":{"$ref":"#/components/schemas/LargeFloat"},"reserves":{"$ref":"#/components/schemas/DexscreenerReserves"},"txnId":{"description":"Transaction ID","type":"string"},"txnIndex":{"description":"Transaction index within block","format":"int32","type":"integer"}},"required":["block","eventType","txnId","txnIndex","eventIndex","maker","pairId"],"type":"object"},"DexscreenerEventsResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/DexscreenerEvent"},"type":"array"}},"required":["events"],"type":"object"},"DexscreenerLatestBlockResponse":{"properties":{"block":{"$ref":"#/components/schemas/DexscreenerBlock"}},"required":["block"],"type":"object"},"DexscreenerPair":{"properties":{"asset0Id":{"description":"First asset ID (immutable order)","type":"string"},"asset1Id":{"description":"Second asset ID (immutable order)","type":"string"},"createdAtBlockNumber":{"description":"Block number when pair was created","format":"int64","type":"integer"},"createdAtBlockTimestamp":{"description":"Timestamp when pair was created","format":"int64","type":"integer"},"createdAtTxnId":{"description":"Transaction ID when pair was created","type":"string"},"creator":{"description":"Address of pair creator","type":"string"},"dexKey":{"description":"DEX identifier","type":"string"},"feeBps":{"description":"Fees in basis points (1% = 100)","format":"int32","type":"integer"},"id":{"description":"Pair ID","type":"string"},"metadata":{"additionalProperties":{"type":"string"},"description":"Optional metadata","type":"object"},"pool":{"description":"Multi-asset pool information","type":"object"}},"required":["id","dexKey","asset0Id","asset1Id","createdAtBlockNumber","createdAtBlockTimestamp","createdAtTxnId","feeBps","metadata"],"type":"object"},"DexscreenerPairResponse":{"properties":{"pair":{"$ref":"#/components/schemas/DexscreenerPair"}},"required":["pair"],"type":"object"},"DexscreenerReserves":{"properties":{"asset0":{"$ref":"#/components/schemas/LargeFloat"},"asset1":{"$ref":"#/components/schemas/LargeFloat"}},"required":["asset0","asset1"],"type":"object"},"Error":{"properties":{"code":{"description":"Error code","format":"int32","type":"integer"},"message":{"description":"Error message","type":"string"}},"required":["code","message"],"type":"object"},"GetPairPoolsRequest":{"properties":{"assets":{"description":"Asset identifiers that form the pair (native or jetton:0:\u003caddress\u003e)","items":{"type":"string"},"maxItems":2,"minItems":2,"type":"array"},"filter_by_type":{"description":"Filter pools by liquidity type (cpmm_v1, cpmm_v2, stable). Case-insensitive.","items":{"type":"string"},"type":"array"},"limit":{"default":20,"description":"Maximum number of pools to return","format":"int32","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Number of pools to skip","format":"int32","minimum":0,"type":"integer"},"pool_addresses":{"description":"Filter pools by explicit pool addresses (user-friendly). When provided, only matching pools are considered.\n","items":{"type":"string"},"type":"array"},"sort_by":{"default":"volume_24h","description":"Pool sorting field (all values in USD). value_usd and rewards_total_usd are only available when wallet_address is provided.\n","enum":["volume_24h","tvl","fees_24h","apr","base_apr","boost_apr","value_usd","rewards_total_usd"],"type":"string"},"sort_direction":{"default":"desc","description":"Direction for sorting","enum":["asc","desc"],"type":"string"},"tags":{"description":"Filter pools by feature tags (currently supported: boosted). Provide multiple tags to require all of them.\n","items":{"type":"string"},"type":"array"},"wallet_address":{"description":"Wallet address to enrich pools with user's liquidity position data. When provided, value_usd and rewards_total_usd fields are available in the response and can be used for sorting.\n","type":"string"}},"required":["assets"],"type":"object"},"GetPoolsRequest":{"properties":{"filter_by_assets":{"description":"List of assets to prioritise (native or jetton:0:\u003caddress\u003e)","items":{"type":"string"},"type":"array"},"filter_by_type":{"description":"Filter pools by liquidity type (cpmm_v1, cpmm_v2, stable). Case-insensitive.","items":{"type":"string"},"type":"array"},"include_assets":{"description":"Filter pools that contain any of the specified assets (native or jetton:0:\u003caddress\u003e)","items":{"type":"string"},"type":"array"},"limit":{"default":20,"description":"Maximum number of pools to return","format":"int32","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Number of pools to skip","format":"int32","minimum":0,"type":"integer"},"pair_pools":{"description":"Pool pagination overrides for specific asset pairs","items":{"$ref":"#/components/schemas/PairPoolsRequest"},"type":"array"},"pool_addresses":{"description":"Filter pools by explicit pool addresses (user-friendly). When provided, only matching pools are considered.\n","items":{"type":"string"},"type":"array"},"sort_by":{"default":"volume_24h","description":"Pool sorting field (all values in USD). value_usd and rewards_total_usd are only available when wallet_address is provided.\n","enum":["volume_24h","tvl","fees_24h","apr","base_apr","boost_apr","value_usd","rewards_total_usd"],"type":"string"},"sort_direction":{"default":"desc","description":"Direction for sorting","enum":["asc","desc"],"type":"string"},"tags":{"description":"Filter pools by feature tags (currently supported: boosted). Provide multiple tags to require all of them.\n","items":{"type":"string"},"type":"array"},"wallet_address":{"description":"Wallet address to enrich pools with user's liquidity position data. When provided, value_usd and rewards_total_usd fields are available in the response and can be used for sorting.\n","type":"string"}},"type":"object"},"HLOCV":{"properties":{"close":{"$ref":"#/components/schemas/LargeFloat"},"high":{"$ref":"#/components/schemas/LargeFloat"},"low":{"$ref":"#/components/schemas/LargeFloat"},"open":{"$ref":"#/components/schemas/LargeFloat"},"raw_open":{"$ref":"#/components/schemas/LargeFloat"},"time":{"format":"int64","type":"integer"},"volume":{"$ref":"#/components/schemas/LargeFloat"}},"required":["time","open","raw_open","high","low","close","volume"],"type":"object"},"Holding":{"properties":{"asset_address":{"description":"Asset address in hex format","type":"string"},"bought_tokens":{"$ref":"#/components/schemas/LargeInteger"},"bought_ton":{"$ref":"#/components/schemas/LargeFloat"},"current_position_value_ton":{"$ref":"#/components/schemas/LargeFloat"},"realized_cost_ton":{"$ref":"#/components/schemas/LargeFloat"},"realized_pnl_percent":{"$ref":"#/components/schemas/LargeFloat"},"realized_pnl_percent_of_total_cost":{"$ref":"#/components/schemas/LargeFloat"},"realized_pnl_ton":{"$ref":"#/components/schemas/LargeFloat"},"remaining_tokens":{"$ref":"#/components/schemas/LargeInteger"},"sold_tokens":{"$ref":"#/components/schemas/LargeInteger"},"sold_ton":{"$ref":"#/components/schemas/LargeFloat"},"total_pnl_percent":{"$ref":"#/components/schemas/LargeFloat"},"total_pnl_ton":{"$ref":"#/components/schemas/LargeFloat"},"unrealized_pnl_percent":{"$ref":"#/components/schemas/LargeFloat"},"unrealized_pnl_ton":{"$ref":"#/components/schemas/LargeFloat"}},"required":["asset_address","bought_ton","bought_tokens","sold_ton","sold_tokens","remaining_tokens","current_position_value_ton","realized_cost_ton","realized_pnl_ton","unrealized_pnl_ton","total_pnl_ton","realized_pnl_percent","unrealized_pnl_percent","realized_pnl_percent_of_total_cost","total_pnl_percent"],"type":"object"},"HoldingsResponse":{"properties":{"holdings":{"description":"List of trader holdings with P\u0026L calculations","items":{"$ref":"#/components/schemas/Holding"},"type":"array"}},"required":["holdings"],"type":"object"},"LargeFloat":{"description":"Float type represented as a string to avoid precision issues","pattern":"^[-+]?[0-9]*\\.?[0-9]+$","type":"string"},"LargeInteger":{"description":"Integer type represented as a string to avoid precision issues","pattern":"^[-+]?[0-9]+$","type":"string"},"LiquidityPool":{"properties":{"asset0":{"description":"Address of the first asset in the pool","type":"string"},"asset1":{"description":"Address of the second asset in the pool","type":"string"},"pool_address":{"description":"Address of the liquidity pool","type":"string"},"pool_type":{"description":"Type of the liquidity pool (e.g., dedust, stonfi_v1, stonfi_v2, blum, tonfun)","type":"string"},"weight":{"$ref":"#/components/schemas/LargeFloat"}},"required":["pool_address","pool_type","asset0","asset1","weight"],"type":"object"},"MemeCoinExtraDetails":{"properties":{"author":{"description":"Address of the author of the memecoin","type":"string"},"contract_type":{"description":"Type of the contract (e.g., \"tonfun\", \"blum\")","type":"string"},"curve_ton_collected":{"$ref":"#/components/schemas/LargeInteger"},"curve_ton_max":{"$ref":"#/components/schemas/LargeInteger"},"memepad":{"description":"Name of the memepad that launched the memecoin","type":"string"},"migration_date":{"description":"Date of migration to the new contract (if applicable)","format":"date-time","type":"string"}},"required":["curve_ton_collected","curve_ton_max","author","memepad","contract_type"],"type":"object"},"PairPoolsRequest":{"properties":{"assets":{"description":"Asset identifiers that form the pair (native or jetton:0:\u003caddress\u003e)","items":{"type":"string"},"maxItems":2,"minItems":2,"type":"array"},"limit":{"default":3,"description":"Maximum number of pools to return for this pair","format":"int32","maximum":50,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Offset for pools inside the pair","format":"int32","minimum":0,"type":"integer"}},"required":["assets"],"type":"object"},"PairPoolsResponse":{"properties":{"assets_metadata":{"additionalProperties":{"$ref":"#/components/schemas/CoinMetadata"},"description":"Metadata keyed by asset identifier for pools in the response","type":"object"},"pools":{"description":"Pools returned for the requested pair","items":{"$ref":"#/components/schemas/Pool"},"type":"array"},"total_count":{"description":"Total number of pools available before pagination","format":"int32","minimum":0,"type":"integer"}},"required":["pools","assets_metadata","total_count"],"type":"object"},"PeriodData":{"properties":{"d7":{"format":"double","type":"number"},"h1":{"format":"double","type":"number"},"h24":{"format":"double","type":"number"},"h6":{"format":"double","type":"number"},"m15":{"format":"double","type":"number"}},"required":["m15","h1","h6","h24","d7"],"type":"object"},"PeriodDataLarge":{"properties":{"d7":{"$ref":"#/components/schemas/LargeFloat"},"h1":{"$ref":"#/components/schemas/LargeFloat"},"h24":{"$ref":"#/components/schemas/LargeFloat"},"h6":{"$ref":"#/components/schemas/LargeFloat"},"m15":{"$ref":"#/components/schemas/LargeFloat"}},"required":["m15","h1","h6","h24","d7"],"type":"object"},"Pool":{"properties":{"address":{"description":"Pool address in user-friendly format","type":"string"},"apr":{"$ref":"#/components/schemas/LargeFloat"},"apr_fees":{"$ref":"#/components/schemas/LargeFloat"},"apr_rewards":{"$ref":"#/components/schemas/LargeFloat"},"assets":{"description":"Pool asset identifiers (native or jetton:0:\u003caddress\u003e)","items":{"type":"string"},"minItems":2,"type":"array"},"creator_fee":{"$ref":"#/components/schemas/LargeInteger"},"dex":{"description":"Source DEX identifier (dedust, dedust_v3_cpmm)","type":"string"},"fee_in_assets":{"description":"Assets that receive protocol fees for this pool","items":{"type":"string"},"type":"array"},"fees":{"description":"Accumulated protocol fees for asset_0 and asset_1","items":{"$ref":"#/components/schemas/LargeInteger"},"minItems":2,"type":"array"},"fees_24h_usd":{"$ref":"#/components/schemas/LargeFloat"},"last_activity_at":{"description":"Timestamp of the latest pool activity used for metrics","format":"date-time","nullable":true,"type":"string"},"locked_liquidity":{"$ref":"#/components/schemas/LargeInteger"},"lp_fee":{"$ref":"#/components/schemas/LargeInteger"},"protocol_fee":{"$ref":"#/components/schemas/LargeInteger"},"reserves":{"description":"Latest pool reserves for asset_0 and asset_1","items":{"$ref":"#/components/schemas/LargeInteger"},"minItems":2,"type":"array"},"reward_assets":{"description":"Assets that can be used to fund future reward programs for this pool","items":{"type":"string"},"type":"array"},"rewards":{"description":"Active reward programs associated with this pool","items":{"$ref":"#/components/schemas/PoolReward"},"type":"array"},"rewards_total_usd":{"$ref":"#/components/schemas/LargeFloat"},"total_supply":{"$ref":"#/components/schemas/LargeInteger"},"trade_fee":{"$ref":"#/components/schemas/LargeInteger"},"tvl_usd":{"$ref":"#/components/schemas/LargeFloat"},"type":{"description":"Pool liquidity type (cpmm_v1, cpmm_v2, stable)","type":"string"},"value_usd":{"$ref":"#/components/schemas/LargeFloat"},"verified":{"description":"Indicates if all pool assets are verified","type":"boolean"},"volume":{"description":"24 hour traded volume in native asset units for asset_0 and asset_1","items":{"$ref":"#/components/schemas/LargeInteger"},"minItems":2,"type":"array"},"volume_24h_usd":{"$ref":"#/components/schemas/LargeFloat"}},"required":["address","type","dex","total_supply","trade_fee","lp_fee","creator_fee","protocol_fee","assets","reserves","fees","fee_in_assets","volume","tvl_usd","volume_24h_usd","fees_24h_usd","apr_fees","apr_rewards","apr","verified"],"type":"object"},"PoolProvider":{"properties":{"assets":{"$ref":"#/components/schemas/PortfolioLiquidityAssetMap"},"liquidity":{"$ref":"#/components/schemas/LargeInteger"},"share":{"$ref":"#/components/schemas/LargeFloat"},"wallet_address":{"description":"Liquidity provider wallet address","type":"string"}},"required":["wallet_address","liquidity","share","assets"],"type":"object"},"PoolProvidersResponse":{"properties":{"assets_metadata":{"additionalProperties":{"$ref":"#/components/schemas/CoinMetadata"},"description":"Metadata keyed by asset identifier present in the response","type":"object"},"providers":{"description":"List of liquidity providers for the pool sorted by liquidity share","items":{"$ref":"#/components/schemas/PoolProvider"},"type":"array"},"total_count":{"description":"Total number of liquidity providers for this pool","format":"int32","type":"integer"}},"required":["providers","assets_metadata","total_count"],"type":"object"},"PoolResponse":{"properties":{"assets_metadata":{"additionalProperties":{"$ref":"#/components/schemas/CoinMetadata"},"description":"Metadata keyed by asset identifier for the pool in the response","type":"object"},"pool":{"$ref":"#/components/schemas/Pool"}},"required":["pool","assets_metadata"],"type":"object"},"PoolReward":{"properties":{"asset":{"description":"Reward asset identifier","type":"string"},"end_date":{"description":"Expected timestamp when the reward program ends","format":"date-time","type":"string"},"remaining_budget":{"$ref":"#/components/schemas/LargeFloat"},"remaining_budget_usd":{"$ref":"#/components/schemas/LargeFloat"},"reward_index":{"description":"Reward index within the pool","format":"int32","type":"integer"},"tokens_per_day":{"$ref":"#/components/schemas/LargeInteger"},"tokens_per_day_usd":{"$ref":"#/components/schemas/LargeFloat"}},"required":["reward_index","asset","tokens_per_day","tokens_per_day_usd","remaining_budget","remaining_budget_usd","end_date"],"type":"object"},"PoolSummaryRequest":{"properties":{"include_assets":{"description":"Filter pools that contain any of the specified assets (native or jetton:0:\u003caddress\u003e)","items":{"type":"string"},"type":"array"}},"type":"object"},"PoolSummaryResponse":{"properties":{"fees_24h_usd":{"$ref":"#/components/schemas/LargeFloat"},"total_value_locked_usd":{"$ref":"#/components/schemas/LargeFloat"},"volume_24h_usd":{"$ref":"#/components/schemas/LargeFloat"}},"required":["total_value_locked_usd","volume_24h_usd","fees_24h_usd"],"type":"object"},"PoolsResponse":{"properties":{"assets_metadata":{"additionalProperties":{"$ref":"#/components/schemas/CoinMetadata"},"description":"Metadata keyed by asset identifier for pools in the response","type":"object"},"pool_rows":{"items":{"$ref":"#/components/schemas/PoolsRow"},"type":"array"},"total_count":{"description":"Total number of asset pairs available before pagination","format":"int32","minimum":0,"type":"integer"}},"required":["pool_rows","assets_metadata","total_count"],"type":"object"},"PoolsRow":{"properties":{"apr":{"$ref":"#/components/schemas/LargeFloat"},"apr_fees":{"$ref":"#/components/schemas/LargeFloat"},"apr_rewards":{"$ref":"#/components/schemas/LargeFloat"},"assets":{"description":"Asset identifiers representing the pair","items":{"type":"string"},"maxItems":2,"minItems":2,"type":"array"},"fees_24h_usd":{"$ref":"#/components/schemas/LargeFloat"},"pools":{"description":"Pools returned for this asset pair","items":{"$ref":"#/components/schemas/Pool"},"type":"array"},"pools_limit":{"description":"Limit applied when selecting pools for this pair","format":"int32","minimum":0,"type":"integer"},"pools_offset":{"description":"Offset applied when selecting pools for this pair","format":"int32","minimum":0,"type":"integer"},"total_pools":{"description":"Total number of pools available for this asset pair","format":"int32","minimum":0,"type":"integer"},"tvl_usd":{"$ref":"#/components/schemas/LargeFloat"},"volume_24h_usd":{"$ref":"#/components/schemas/LargeFloat"}},"required":["assets","tvl_usd","volume_24h_usd","fees_24h_usd","apr_fees","apr_rewards","apr","pools","pools_offset","pools_limit","total_pools"],"type":"object"},"PortfolioBoostReward":{"properties":{"amount":{"$ref":"#/components/schemas/LargeInteger"},"amount_usd":{"$ref":"#/components/schemas/LargeFloat"},"pool_address":{"description":"Liquidity pool address","type":"string"},"position_address":{"description":"Liquidity position address","type":"string"},"reward_asset":{"description":"Reward asset address","type":"string"},"reward_index":{"description":"Reward index within the pool","format":"int32","type":"integer"}},"required":["pool_address","position_address","reward_index","reward_asset","amount","amount_usd"],"type":"object"},"PortfolioCreatorEarning":{"properties":{"assets":{"$ref":"#/components/schemas/PortfolioEarningAssetMap"},"pool_address":{"description":"Liquidity pool address","type":"string"}},"required":["pool_address","assets"],"type":"object"},"PortfolioData":{"properties":{"asset":{"description":"Asset address","type":"string"},"balance":{"$ref":"#/components/schemas/LargeInteger"},"balance_formatted":{"$ref":"#/components/schemas/LargeFloat"},"jetton_wallet":{"description":"Jetton wallet address for this balance","type":"string"},"memecoin_extra_details":{"$ref":"#/components/schemas/MemeCoinExtraDetails"},"metadata":{"$ref":"#/components/schemas/CoinMetadata"},"price":{"$ref":"#/components/schemas/PriceInfo"},"value_ton":{"$ref":"#/components/schemas/LargeFloat"},"value_usd":{"$ref":"#/components/schemas/LargeFloat"},"verification_level":{"description":"Verification level of the token (0-4)","format":"int32","type":"integer"}},"required":["asset","balance","balance_formatted","metadata","price","price_usd","price_ton","value_usd","value_ton","verification_level"],"type":"object"},"PortfolioEarningAssetDetails":{"properties":{"amount":{"$ref":"#/components/schemas/LargeInteger"},"amount_usd":{"$ref":"#/components/schemas/LargeFloat"}},"required":["amount","amount_usd"],"type":"object"},"PortfolioEarningAssetMap":{"additionalProperties":{"$ref":"#/components/schemas/PortfolioEarningAssetDetails"},"description":"Asset breakdown keyed by asset address","type":"object"},"PortfolioEarningsResponse":{"properties":{"boost_rewards":{"description":"List of boost reward balances by position and reward index","items":{"$ref":"#/components/schemas/PortfolioBoostReward"},"type":"array"},"creator_earnings":{"description":"List of creator fee earnings by pool","items":{"$ref":"#/components/schemas/PortfolioCreatorEarning"},"type":"array"},"fee_earnings":{"description":"List of liquidity provider fee earnings by position","items":{"$ref":"#/components/schemas/PortfolioFeeEarning"},"type":"array"},"meme_creator_earnings":{"description":"List of meme creator fee earnings by token","items":{"$ref":"#/components/schemas/PortfolioMemeCreatorEarning"},"type":"array"}},"required":["fee_earnings","creator_earnings","meme_creator_earnings","boost_rewards"],"type":"object"},"PortfolioFeeEarning":{"properties":{"assets":{"$ref":"#/components/schemas/PortfolioEarningAssetMap"},"claimed_assets":{"$ref":"#/components/schemas/PortfolioEarningAssetMap"},"pool_address":{"description":"Liquidity pool address","type":"string"},"position_address":{"description":"Liquidity position address","type":"string"}},"required":["pool_address","position_address","assets","claimed_assets"],"type":"object"},"PortfolioLiquidityAssetMap":{"additionalProperties":{"$ref":"#/components/schemas/PortfolioEarningAssetDetails"},"type":"object"},"PortfolioLiquidityPosition":{"properties":{"apr":{"$ref":"#/components/schemas/LargeFloat"},"assets":{"$ref":"#/components/schemas/PortfolioLiquidityAssetMap"},"base_apr":{"$ref":"#/components/schemas/LargeFloat"},"boost_apr":{"$ref":"#/components/schemas/LargeFloat"},"liquidity":{"$ref":"#/components/schemas/LargeInteger"},"liquidity_percentage":{"$ref":"#/components/schemas/LargeFloat"},"locked_liquidity":{"$ref":"#/components/schemas/LargeInteger"},"pool_address":{"description":"Pool address","type":"string"},"position_address":{"description":"Liquidity position address","type":"string"},"rewards_total_usd":{"$ref":"#/components/schemas/LargeFloat"},"value_usd":{"$ref":"#/components/schemas/LargeFloat"}},"required":["position_address","pool_address","liquidity","liquidity_percentage","assets","value_usd","apr","base_apr","boost_apr","rewards_total_usd"],"type":"object"},"PortfolioLiquidityPositionResponse":{"properties":{"assets_metadata":{"additionalProperties":{"$ref":"#/components/schemas/CoinMetadata"},"description":"Metadata keyed by asset identifier present in the response","type":"object"},"position":{"$ref":"#/components/schemas/PortfolioLiquidityPosition"}},"required":["position","assets_metadata"],"type":"object"},"PortfolioMemeCreatorEarning":{"properties":{"assets":{"$ref":"#/components/schemas/PortfolioEarningAssetMap"},"claimed_assets":{"$ref":"#/components/schemas/PortfolioEarningAssetMap"},"token_address":{"description":"Address of the meme token","type":"string"}},"required":["token_address","assets","claimed_assets"],"type":"object"},"PortfolioResponse":{"properties":{"jetton_balances":{"description":"List of balances in the portfolio","items":{"$ref":"#/components/schemas/PortfolioData"},"type":"array"},"total_value_ton":{"$ref":"#/components/schemas/LargeFloat"},"total_value_usd":{"$ref":"#/components/schemas/LargeFloat"}},"required":["total_value_usd","total_value_ton","jetton_balances"],"type":"object"},"PriceInfo":{"properties":{"ton_change":{"allOf":[{"$ref":"#/components/schemas/PeriodData"}]},"ton_value":{"$ref":"#/components/schemas/LargeFloat"},"usd_change":{"allOf":[{"$ref":"#/components/schemas/PeriodData"}]},"usd_value":{"$ref":"#/components/schemas/LargeFloat"}},"required":["usd_value","ton_value"],"type":"object"},"ResolverAddressResponse":{"properties":{"resolver_address":{"description":"Resolver address in user-friendly format, or empty string if not available","type":"string"}},"required":["resolver_address"],"type":"object"},"TopTrader":{"properties":{"bought_tokens":{"description":"Total amount of tokens bought","type":"string"},"bought_usd":{"description":"Total USD value of tokens bought","type":"string"},"buy_txns":{"description":"Number of buy transactions","format":"int64","type":"integer"},"rank":{"description":"Rank based on total P\u0026L","format":"int64","type":"integer"},"realized_pnl_ton":{"description":"Realized profit/loss in TON","type":"string"},"realized_pnl_usd":{"description":"Realized profit/loss in USD","type":"string"},"remaining_percent_of_buys":{"description":"Percentage of bought tokens still held","format":"double","type":"number"},"remaining_tokens":{"description":"Amount of tokens still held","type":"string"},"remaining_value_ton":{"description":"Current TON value of remaining tokens","type":"string"},"remaining_value_usd":{"description":"Current USD value of remaining tokens","type":"string"},"sell_txns":{"description":"Number of sell transactions","format":"int64","type":"integer"},"sold_tokens":{"description":"Total amount of tokens sold","type":"string"},"sold_usd":{"description":"Total USD value of tokens sold","type":"string"},"total_pnl_ton":{"description":"Total profit/loss in TON (realized + unrealized)","type":"string"},"total_pnl_usd":{"description":"Total profit/loss in USD (realized + unrealized)","type":"string"},"trader":{"description":"Trader address","type":"string"},"unrealized_pnl_ton":{"description":"Unrealized profit/loss in TON","type":"string"},"unrealized_pnl_usd":{"description":"Unrealized profit/loss in USD","type":"string"}},"required":["rank","trader","bought_usd","bought_tokens","buy_txns","sold_usd","sold_tokens","sell_txns","remaining_tokens","remaining_value_usd","remaining_value_ton","remaining_percent_of_buys","realized_pnl_usd","realized_pnl_ton","unrealized_pnl_usd","unrealized_pnl_ton","total_pnl_usd","total_pnl_ton"],"type":"object"},"TopTradersResponse":{"properties":{"traders":{"description":"List of top traders sorted by total P\u0026L","items":{"$ref":"#/components/schemas/TopTrader"},"type":"array"}},"required":["traders"],"type":"object"},"TraderInfoListResponse":{"properties":{"traders":{"description":"List of trader statistics","items":{"$ref":"#/components/schemas/TraderInfoResponse"},"type":"array"}},"required":["traders"],"type":"object"},"TraderInfoResponse":{"properties":{"end_date":{"description":"End date for statistics period","format":"date-time","type":"string"},"start_date":{"description":"Start date for statistics period","format":"date-time","type":"string"},"trader_address":{"description":"Address of the trader","type":"string"},"transactions":{"description":"Number of buy transactions in the period","format":"int64","type":"integer"},"volume":{"$ref":"#/components/schemas/LargeFloat"},"volume_ton":{"$ref":"#/components/schemas/LargeFloat"}},"required":["trader_address","transactions","volume","volume_ton"],"type":"object"},"TradersInfo":{"properties":{"buy":{"allOf":[{"$ref":"#/components/schemas/PeriodData"}]},"sell":{"allOf":[{"$ref":"#/components/schemas/PeriodData"}]},"total":{"allOf":[{"$ref":"#/components/schemas/PeriodData"}]}},"required":["total","buy","sell"],"type":"object"},"TransactionsInfo":{"properties":{"buy":{"allOf":[{"$ref":"#/components/schemas/PeriodData"}]},"sell":{"allOf":[{"$ref":"#/components/schemas/PeriodData"}]}},"required":["buy","sell"],"type":"object"},"TrendingCoin":{"properties":{"asset_address":{"description":"Asset address in hex format","type":"string"},"burst_score":{"$ref":"#/components/schemas/LargeFloat"},"buy_pressure":{"$ref":"#/components/schemas/LargeFloat"},"liquidity_usd":{"$ref":"#/components/schemas/LargeFloat"},"market_cap_usd":{"$ref":"#/components/schemas/LargeFloat"},"market_tier":{"description":"Market capitalization tier","enum":["nano","micro","mid","large"],"type":"string"},"memecoin_extra_details":{"$ref":"#/components/schemas/MemeCoinExtraDetails"},"momentum_score":{"$ref":"#/components/schemas/LargeFloat"},"norm_tr_1h":{"$ref":"#/components/schemas/LargeFloat"},"norm_tr_24h":{"$ref":"#/components/schemas/LargeFloat"},"norm_vol_1h":{"$ref":"#/components/schemas/LargeFloat"},"norm_vol_24h":{"$ref":"#/components/schemas/LargeFloat"},"price_acceleration":{"$ref":"#/components/schemas/LargeFloat"},"price_usd":{"$ref":"#/components/schemas/LargeFloat"},"price_usd_15m_change":{"$ref":"#/components/schemas/LargeFloat"},"price_usd_1h_change":{"$ref":"#/components/schemas/LargeFloat"},"price_usd_24h_change":{"$ref":"#/components/schemas/LargeFloat"},"price_usd_6h_change":{"$ref":"#/components/schemas/LargeFloat"},"quality_score":{"$ref":"#/components/schemas/LargeFloat"},"rank_in_tier":{"description":"Ranking within market tier","format":"int64","type":"integer"},"strength_score":{"$ref":"#/components/schemas/LargeFloat"},"ticker":{"description":"Coin ticker symbol","type":"string"},"tier_median_traders_24h":{"$ref":"#/components/schemas/LargeFloat"},"tier_median_vol_24h":{"$ref":"#/components/schemas/LargeFloat"},"title":{"description":"Coin title/name","type":"string"},"tr_burst_ratio":{"$ref":"#/components/schemas/LargeFloat"},"traders_1h_count":{"description":"Number of unique traders in last hour","format":"int64","type":"integer"},"traders_24h_count":{"description":"Number of unique traders in last 24 hours","format":"int64","type":"integer"},"transactions_1h_count":{"description":"Number of transactions in last hour","format":"int64","type":"integer"},"trend_score":{"$ref":"#/components/schemas/LargeFloat"},"vol_burst_ratio":{"$ref":"#/components/schemas/LargeFloat"},"vol_to_liq":{"$ref":"#/components/schemas/LargeFloat"},"volume_usd_1h":{"$ref":"#/components/schemas/LargeFloat"},"volume_usd_24h":{"$ref":"#/components/schemas/LargeFloat"}},"required":["asset_address","title","ticker","market_tier","rank_in_tier","trend_score"],"type":"object"},"VolumeInfo":{"properties":{"buy_periods":{"allOf":[{"$ref":"#/components/schemas/PeriodDataLarge"}]},"change":{"allOf":[{"$ref":"#/components/schemas/PeriodData"}]},"periods":{"allOf":[{"$ref":"#/components/schemas/PeriodDataLarge"}]},"sell_periods":{"allOf":[{"$ref":"#/components/schemas/PeriodDataLarge"}]},"total_volume":{"description":"All-time total trading volume (only included when calculate_total_volume flag is set)","properties":{"ton":{"$ref":"#/components/schemas/LargeInteger"},"usd":{"$ref":"#/components/schemas/LargeFloat"}},"required":["usd","ton"],"type":"object"}},"required":["periods","buy_periods","sell_periods","change"],"type":"object"}}},"info":{"title":"Nova API","version":"1.0.0"},"openapi":"3.0.0","paths":{"/affiliate/accounts/{id_or_controller_address}":{"get":{"operationId":"get_affiliate_account","parameters":[{"description":"Affiliate account ID or controller address","in":"path","name":"id_or_controller_address","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AffiliateAccount"},"type":"array"}}},"description":"Affiliate accounts response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Account not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get affiliate account by ID or controller address"}},"/affiliate/accounts/{id_or_controller_address}/volume":{"get":{"operationId":"get_affiliate_account_volume","parameters":[{"description":"Affiliate account ID or controller address","in":"path","name":"id_or_controller_address","required":true,"schema":{"type":"string"}},{"description":"Optional wallet address to retrieve its trading volume within this affiliate account","in":"query","name":"wallet_address","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateAccountVolumeResponse"}}},"description":"Affiliate account volume response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid affiliate account address format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Affiliate account not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get affiliate account trading volumes by ID or controller address"}},"/affiliate/{account_id_or_controller_address}/referrals":{"get":{"operationId":"get_affiliate_referrals","parameters":[{"description":"Affiliate account ID or controller address to get referrals for","in":"path","name":"account_id_or_controller_address","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateReferralsResponse"}}},"description":"Affiliate referrals response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid affiliate account address format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Affiliate account not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get referrals for a specific affiliate account or controller"}},"/affiliate/{wallet_address}/referrer":{"get":{"operationId":"get_affiliate_account_referrer_by_wallet_address","parameters":[{"description":"Wallet address to get affiliate account referrer for","in":"path","name":"wallet_address","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateAccountReferrer"}}},"description":"Affiliate account referrer response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Affiliate account not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get affiliate account referrer by wallet address"}},"/chart":{"get":{"operationId":"get_chart","parameters":[{"description":"Time period for the chart (e.g., 1s, 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1d, 7d)","in":"query","name":"period","required":true,"schema":{"enum":["1s","1m","5m","15m","30m","1h","4h","6h","12h","1d","7d"],"type":"string"}},{"description":"Start date for the chart data","in":"query","name":"start_date","schema":{"format":"date-time","type":"string"}},{"description":"End date for the chart data","in":"query","name":"end_date","schema":{"format":"date-time","type":"string"}},{"description":"Maximum number of data points to return (default is 1000)","in":"query","name":"limit","schema":{"default":1000,"format":"int32","maximum":5000,"minimum":1,"type":"integer"}},{"description":"Asset for which the chart data is requested","in":"query","name":"asset","required":true,"schema":{"type":"string"}},{"description":"Opposite asset (optional)","in":"query","name":"opposite_asset","schema":{"type":"string"}},{"description":"Enable materialized hypertable fallback for historic candles","in":"query","name":"use_materialized","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartResponse"}}},"description":"Chart data response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid parameter format)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get chart data"}},"/chart_by_pool_address":{"get":{"operationId":"get_chart_by_pool_address","parameters":[{"description":"Time period for the chart (e.g., 1s, 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1d, 7d)","in":"query","name":"period","required":true,"schema":{"enum":["1s","1m","5m","15m","30m","1h","4h","6h","12h","1d","7d"],"type":"string"}},{"description":"Start date for the chart data","in":"query","name":"start_date","schema":{"format":"date-time","type":"string"}},{"description":"End date for the chart data","in":"query","name":"end_date","schema":{"format":"date-time","type":"string"}},{"description":"Maximum number of data points to return (default is 1000)","in":"query","name":"limit","schema":{"default":1000,"format":"int32","maximum":5000,"minimum":1,"type":"integer"}},{"description":"Asset for which the chart data is requested (price will be in the opposite asset)","in":"query","name":"asset","required":true,"schema":{"type":"string"}},{"description":"Address of the pool for which the chart data is requested","in":"query","name":"pool_address","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartByPoolAddressResponse"}}},"description":"Chart data response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid parameter format)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Returns chart data for a specific pool address, TON and USD price is not included, price is the swap price (in the opposite asset). Volume is provided in USD."}},"/coin":{"get":{"operationId":"get_coin","parameters":[{"description":"Asset for which the coin data is requested","in":"query","name":"asset","required":true,"schema":{"type":"string"}},{"description":"Include extra details that requires extra requests (response will be slower)","in":"query","name":"extra_details","schema":{"default":false,"type":"boolean"}},{"description":"Include extra details for memecoins (response will be slower)","in":"query","name":"memecoin_extra_details","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Coin"}}},"description":"Coin data response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid parameter format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found (e.g., coin not found for the given asset)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get coin data by asset and period"}},"/coin_transactions":{"get":{"operationId":"get_coin_transactions","parameters":[{"description":"Asset address for which the transaction data is requested","in":"query","name":"asset","required":true,"schema":{"type":"string"}},{"description":"Optional pool address to filter transactions","in":"query","name":"pool_address","schema":{"type":"string"}},{"description":"Optional trader address to filter transactions","in":"query","name":"trader_address","schema":{"type":"string"}},{"description":"Maximum number of transactions to return","in":"query","name":"limit","schema":{"default":20,"format":"int32","maximum":100,"type":"integer"}},{"description":"Number of transactions to skip","in":"query","name":"offset","schema":{"default":0,"format":"int32","type":"integer"}},{"description":"Optional inclusive start date for filtering transactions (ISO 8601 format)","in":"query","name":"start_date","schema":{"format":"date-time","type":"string"}},{"description":"Optional inclusive end date for filtering transactions (ISO 8601 format)","in":"query","name":"end_date","schema":{"format":"date-time","type":"string"}},{"description":"Minimum USD volume for returned transactions (must be less than volume_usd_max when both set)","in":"query","name":"volume_usd_min","schema":{"$ref":"#/components/schemas/LargeFloat"}},{"description":"Maximum USD volume for returned transactions (must be greater than volume_usd_min when both set)","in":"query","name":"volume_usd_max","schema":{"$ref":"#/components/schemas/LargeFloat"}},{"description":"Optional transaction type filter","in":"query","name":"type","schema":{"enum":["buy","sell"],"type":"string"}},{"description":"Field to sort transactions by","in":"query","name":"sort_by","schema":{"enum":["age"],"type":"string"}},{"description":"Direction for sorting","in":"query","name":"sort_direction","schema":{"default":"desc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoinTransactionsResponse"}}},"description":"Transaction history response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid parameter format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Asset not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get transaction history for a specific coin"}},"/coins":{"get":{"operationId":"get_coins","parameters":[{"description":"Search term (name, ticker or address)","in":"query","name":"query","schema":{"type":"string"}},{"description":"Maximum number of coins to return","in":"query","name":"limit","schema":{"default":20,"format":"int32","maximum":500,"type":"integer"}},{"description":"Number of coins to skip","in":"query","name":"offset","schema":{"default":0,"format":"int32","type":"integer"}},{"description":"Field to sort by","in":"query","name":"sort_by","schema":{"enum":["price","market_cap","liquidity","holders","age","price_change","transactions","volume","curve_progress"],"type":"string"}},{"description":"Period for sorting (required if sort_by price_change, volume, transactions is used)","in":"query","name":"sort_period","schema":{"enum":["15m","1h","6h","24h","7d"],"type":"string"}},{"description":"Direction for sorting","in":"query","name":"sort_direction","schema":{"default":"desc","enum":["asc","desc"],"type":"string"}},{"description":"Comma-separated list of assets to filter by (if provided, only these assets will be returned)","in":"query","name":"filter_by_assets","schema":{"type":"string"}},{"description":"Comma-separated list of verification levels (1-4) to filter by (if provided, only these levels will be returned)","in":"query","name":"filter_by_verification_level","schema":{"default":"3,4","type":"string"}},{"description":"Comma-separated list of tags to exclude from the results","in":"query","name":"exclude_tags","schema":{"type":"string"}},{"description":"Comma-separated list of tags to filter by (if provided, only coins with these tags will be returned)","in":"query","name":"filter_by_tags","schema":{"type":"string"}},{"description":"Comma-separated list of assets to exclude from the results","in":"query","name":"exclude_assets","schema":{"type":"string"}},{"description":"If true, returns a compact version of the coin data (smaller response size)","in":"query","name":"compact","schema":{"default":false,"type":"boolean"}},{"description":"Filter by author address (if provided, only coins created by this author will be returned)","in":"query","name":"filter_by_author","schema":{"type":"string"}},{"description":"Include extra details for memecoins (response will be slower)","in":"query","name":"memecoin_extra_details","schema":{"default":false,"type":"boolean"}},{"description":"Calculate all-time total trading volume (in TON and USD) for each coin (response will be slower)","in":"query","name":"calculate_total_volume","schema":{"default":false,"type":"boolean"}},{"description":"Minimum liquidity in USD","in":"query","name":"liquidity_usd_min","schema":{"$ref":"#/components/schemas/LargeFloat"}},{"description":"Maximum liquidity in USD","in":"query","name":"liquidity_usd_max","schema":{"$ref":"#/components/schemas/LargeFloat"}},{"description":"Minimum number of holders","in":"query","name":"holders_min","schema":{"$ref":"#/components/schemas/LargeInteger"}},{"description":"Maximum number of holders","in":"query","name":"holders_max","schema":{"$ref":"#/components/schemas/LargeInteger"}},{"description":"Minimum market cap in USD","in":"query","name":"market_cap_usd_min","schema":{"$ref":"#/components/schemas/LargeFloat"}},{"description":"Maximum market cap in USD","in":"query","name":"market_cap_usd_max","schema":{"$ref":"#/components/schemas/LargeFloat"}},{"description":"Filter coins created after this date (ISO 8601 format, e.g., 2025-01-20T00:00:00Z)","in":"query","name":"created_at_min","schema":{"format":"date-time","type":"string"}},{"description":"Filter coins created before this date (ISO 8601 format, e.g., 2025-01-20T00:00:00Z)","in":"query","name":"created_at_max","schema":{"format":"date-time","type":"string"}},{"description":"Period for volume and transaction filters (required when using volume or transaction filters)","in":"query","name":"filter_period","schema":{"enum":["15m","1h","6h","24h","7d"],"type":"string"}},{"description":"Minimum volume in USD for the specified period","in":"query","name":"volume_usd_min","schema":{"$ref":"#/components/schemas/LargeFloat"}},{"description":"Maximum volume in USD for the specified period","in":"query","name":"volume_usd_max","schema":{"$ref":"#/components/schemas/LargeFloat"}},{"description":"Minimum number of transactions for the specified period","in":"query","name":"transactions_min","schema":{"$ref":"#/components/schemas/LargeInteger"}},{"description":"Maximum number of transactions for the specified period","in":"query","name":"transactions_max","schema":{"$ref":"#/components/schemas/LargeInteger"}},{"description":"If true, skips the potentially expensive total count calculation for better performance","in":"query","name":"skip_total_count","schema":{"default":false,"type":"boolean"}},{"description":"Minimum bonding curve percentage (0-100)","in":"query","name":"bonding_curve_percentage_min","schema":{"$ref":"#/components/schemas/LargeFloat"}},{"description":"Maximum bonding curve percentage (0-100)","in":"query","name":"bonding_curve_percentage_max","schema":{"$ref":"#/components/schemas/LargeFloat"}},{"description":"If true, includes coins even without trades","in":"query","name":"include_without_price","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoinsResponse"}}},"description":"A list of coins"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid parameter format)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get a list of coins"}},"/coins/{asset}/resolver":{"get":{"operationId":"get_coin_resolver","parameters":[{"description":"Asset address for which the resolver is requested","in":"path","name":"asset","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolverAddressResponse"}}},"description":"Resolver address (empty string if no resolver or coin doesn't exist)"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid asset format)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get resolver address for a coin"}},"/deposits/{pool_address}/{wallet_address}":{"get":{"operationId":"get_deposits","parameters":[{"description":"Pool address in user-friendly format or base64 notation","in":"path","name":"pool_address","required":true,"schema":{"type":"string"}},{"description":"Wallet address (initiator) to filter deposits","in":"path","name":"wallet_address","required":true,"schema":{"type":"string"}},{"description":"Maximum number of deposits to return","in":"query","name":"limit","schema":{"default":20,"format":"int32","maximum":100,"minimum":1,"type":"integer"}},{"description":"Number of deposits to skip","in":"query","name":"offset","schema":{"default":0,"format":"int32","minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DepositsResponse"}}},"description":"Deposits response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid address format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Pool or wallet not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get deposits for a specific pool and wallet address"}},"/dexscreener_api/asset":{"get":{"operationId":"dexscreener_get_asset","parameters":[{"description":"Asset ID (case-sensitive, checksummed addresses recommended for EVM)","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexscreenerAssetResponse"}}},"description":"Asset information response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Asset not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get asset information by ID"}},"/dexscreener_api/dedust_memepad/asset":{"get":{"operationId":"dexscreener_memepad_get_asset","parameters":[{"description":"Asset ID (case-sensitive, checksummed addresses recommended for EVM)","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexscreenerAssetResponse"}}},"description":"Asset information response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Asset not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get dedust memepad asset information by ID"}},"/dexscreener_api/dedust_memepad/events":{"get":{"operationId":"dexscreener_memepad_get_events","parameters":[{"description":"Starting block number (inclusive)","in":"query","name":"fromBlock","required":true,"schema":{"format":"int64","type":"integer"}},{"description":"Ending block number (inclusive)","in":"query","name":"toBlock","required":true,"schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexscreenerEventsResponse"}}},"description":"Events response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid block range)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get dedust memepad trade events for a block range"}},"/dexscreener_api/dedust_memepad/latest-block":{"get":{"operationId":"dexscreener_memepad_get_latest_block","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexscreenerLatestBlockResponse"}}},"description":"Latest block response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get the latest block available for dedust memepad data indexing"}},"/dexscreener_api/dedust_memepad/pair":{"get":{"operationId":"dexscreener_memepad_get_pair","parameters":[{"description":"Pair ID (meme token address)","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexscreenerPairResponse"}}},"description":"Pair information response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Pair not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get dedust memepad trading pair information by ID"}},"/dexscreener_api/events":{"get":{"operationId":"dexscreener_get_events","parameters":[{"description":"Starting block number (inclusive)","in":"query","name":"fromBlock","required":true,"schema":{"format":"int64","type":"integer"}},{"description":"Ending block number (inclusive)","in":"query","name":"toBlock","required":true,"schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexscreenerEventsResponse"}}},"description":"Events response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid block range)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get swap and liquidity events for a block range"}},"/dexscreener_api/latest-block":{"get":{"operationId":"dexscreener_get_latest_block","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexscreenerLatestBlockResponse"}}},"description":"Latest block response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get the latest block available for data indexing"}},"/dexscreener_api/pair":{"get":{"operationId":"dexscreener_get_pair","parameters":[{"description":"Pair ID","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexscreenerPairResponse"}}},"description":"Pair information response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Pair not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get trading pair information by ID"}},"/get_pair_pools":{"post":{"operationId":"get_pair_pools","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPairPoolsRequest"}}},"description":"Exact pair filtering options","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PairPoolsResponse"}}},"description":"Liquidity pools response for the requested pair"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid parameter format)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get liquidity pools for an exact asset pair"}},"/get_pools":{"post":{"operationId":"get_pools","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPoolsRequest"}}},"description":"Pool filtering options"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoolsResponse"}}},"description":"Liquidity pools response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid parameter format)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get liquidity pools"}},"/holdings/{trader_address}":{"get":{"operationId":"get_holdings","parameters":[{"description":"Trader address for which the holdings are requested","in":"path","name":"trader_address","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoldingsResponse"}}},"description":"Trader holdings response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid trader address format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found (e.g., trader not found)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get trader's asset holdings with P\u0026L calculations"}},"/pools/summary":{"post":{"operationId":"get_pool_summary","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoolSummaryRequest"}}},"description":"Pool summary filtering options"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoolSummaryResponse"}}},"description":"Aggregated liquidity pools metrics"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid parameter format)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get aggregated liquidity pools metrics"}},"/pools/{pool_address}":{"get":{"operationId":"get_pool_by_address","parameters":[{"description":"Pool address in user-friendly format or base64 notation","in":"path","name":"pool_address","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoolResponse"}}},"description":"Liquidity pool details"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid pool address format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Pool not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get a liquidity pool by address"}},"/pools/{pool_address}/liquidity_position/{wallet_address}":{"get":{"operationId":"get_pool_liquidity_position","parameters":[{"description":"Pool address in user-friendly format or base64 notation","in":"path","name":"pool_address","required":true,"schema":{"type":"string"}},{"description":"Wallet address holding the liquidity position","in":"path","name":"wallet_address","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioLiquidityPositionResponse"}}},"description":"Portfolio liquidity position response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid pool or wallet address format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found (e.g., position not found)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get wallet liquidity position for a pool"}},"/pools/{pool_address}/providers":{"get":{"operationId":"get_pool_providers","parameters":[{"description":"Pool address in user-friendly format or base64 notation","in":"path","name":"pool_address","required":true,"schema":{"type":"string"}},{"description":"Maximum number of providers to return","in":"query","name":"limit","schema":{"default":20,"format":"int32","maximum":100,"minimum":1,"type":"integer"}},{"description":"Number of providers to skip before collecting results","in":"query","name":"offset","schema":{"default":0,"format":"int32","minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoolProvidersResponse"}}},"description":"Liquidity providers response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid pool address format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Pool not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get liquidity providers for a pool"}},"/portfolio/{wallet_address}":{"get":{"operationId":"get_portfolio","parameters":[{"description":"Wallet address for which the portfolio is requested","in":"path","name":"wallet_address","required":true,"schema":{"type":"string"}},{"description":"Comma-separated list of verification levels (1-4) to filter by (if provided, only these levels will be returned)","in":"query","name":"filter_by_verification_level","schema":{"default":"3,4","type":"string"}},{"description":"Include memecoin extra details in the response","in":"query","name":"memecoin_extra_details","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioResponse"}}},"description":"Portfolio response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid wallet address format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found (e.g., wallet not found)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get user's portfolio with jetton balances and their values"}},"/portfolio/{wallet_address}/earnings":{"get":{"operationId":"get_portfolio_earnings","parameters":[{"description":"Wallet address for which the portfolio earnings are requested","in":"path","name":"wallet_address","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioEarningsResponse"}}},"description":"Portfolio earnings response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid wallet address format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found (e.g., wallet not found)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get user's portfolio earnings breakdown"}},"/top_traders/{asset}":{"get":{"operationId":"get_top_traders","parameters":[{"description":"Asset address for which to get top traders","in":"path","name":"asset","required":true,"schema":{"type":"string"}},{"description":"Number of days to look back from now (e.g., 7 for last week, 30 for last month)","in":"query","name":"period_days","schema":{"default":30,"maximum":365,"minimum":1,"type":"integer"}},{"description":"Field to sort traders by","in":"query","name":"sort_by","schema":{"default":"total_pnl_usd","enum":["total_pnl_usd","realized_pnl_usd","unrealized_pnl_usd","bought_usd","sold_usd","remaining_tokens"],"type":"string"}},{"description":"Sort direction","in":"query","name":"sort_direction","schema":{"default":"desc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopTradersResponse"}}},"description":"Top traders response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid parameter format)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get top traders by P\u0026L for a specific asset"}},"/trader_info":{"get":{"operationId":"get_trader_info","parameters":[{"description":"Comma-separated list of trader addresses to get information for","in":"query","name":"trader_addresses","required":true,"schema":{"type":"string"}},{"description":"Start date for statistics (ISO 8601 format, e.g., 2025-01-20T00:00:00Z)","in":"query","name":"start_date","schema":{"format":"date-time","type":"string"}},{"description":"End date for statistics (ISO 8601 format, e.g., 2025-01-22T00:00:00Z)","in":"query","name":"end_date","schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TraderInfoListResponse"}}},"description":"Trader information response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request (e.g., invalid parameter format)"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found (e.g., trader not found)"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get trader statistics and transaction information"}},"/trending_coins":{"get":{"operationId":"get_trending_coins","parameters":[{"description":"Include memecoin extra details in the response","in":"query","name":"memecoin_extra_details","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/TrendingCoin"},"type":"array"}}},"description":"Trending coins response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get trending coins based on algorithmic scoring"}}},"servers":[{"description":"Local server","url":"/v1/api"},{"description":"Dev server","url":"https://api.dev.core64.dev/v1/api"},{"description":"Production server","url":"https://api-mainnet.dedust.io/v1/api"}]}