{"endpoint":"/api/monitor/position","method":"POST","service_trust":"https://defi-shield-hazel.vercel.app/api/trust-signal","free_check":{"endpoint":"https://defi-shield-hazel.vercel.app/api/free/token-check","method":"POST","price":"FREE","note":"Try before you buy — free basic token safety check with risk math."},"also_available_on":{"virtuals_acp":{"agent":"Authensor","agent_id":18805,"offerings":["pre_trade_safety","token_deep_scan","wallet_report","batch_seal"],"marketplace":"https://app.virtuals.io/acp/scan/agents","note":"Same service, accessible to 18,000+ autonomous agents on Virtuals Protocol."},"mcp_server":{"package":"devsecure-mcp","install":"npx devsecure-mcp","tools":67,"note":"Install as MCP server in Claude, Cursor, or any MCP-compatible client for direct tool access."},"bazaar":"https://defi-shield-hazel.vercel.app/.well-known/x402","agent_card":"https://defi-shield-hazel.vercel.app/.well-known/agent-card.json"},"powered_by":"DeFi Shield by Authensor","price":"$0.25","description":"Analyze a wallet's position in a specific token. Fetches on-chain transfer history from BaseScan and current price from DEX Screener to estimate balance, entry price, current value, and PnL.","llm_usage_prompt":"Call this endpoint when you need to check a wallet's position in a specific token on Base. Provide wallet_address (0x, 42 chars) and token_address (0x, 42 chars). Returns: estimated current balance (from net transfers), current token price in USD, current position value, estimated entry price (approximated from first transfer timing and price change data), PnL estimate (absolute USD and percentage), price change since entry, number of transfers analyzed, and net tokens received/sent. Use this for portfolio monitoring, profit-taking decisions, or risk assessment on individual positions. Note: entry price is an approximation based on available data. Costs $0.25 via x402.","params":{"wallet_address":"string -- Ethereum wallet address (0x + 40 hex chars)","token_address":"string -- Token contract address (0x + 40 hex chars)"},"exampleRequest":{"wallet_address":"0x1234567890abcdef1234567890abcdef12345678","token_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"exampleResponse":{"wallet_address":"0x1234567890abcdef1234567890abcdef12345678","token_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","current_balance_estimate":"1500.000000","current_price_usd":1,"current_value_usd":1500,"entry_estimate":{"avg_price":0.999,"first_transfer_date":"2026-01-15T10:30:00.000Z"},"pnl_estimate":{"absolute_usd":1.5,"percentage":0.1},"price_change_since_entry":0.1,"transfers_analyzed":12,"net_tokens_received":"2000.000000","net_tokens_sent":"500.000000","response_time_ms":650,"timestamp":"2026-03-06T12:00:00.000Z"}}