{"uid":"cap_y81FSC0-M_9j3BjLVmxop","slug":"phantom-api-metis-token-balances-07213447","name":"Phantom API — Metis Token Balances","description":"Lightning-fast access to blockchain data, smart contract insights, and Web3 infrastructure across 57+ networks. Pay-per-call via x402.","url":"https://phantom-api-omega.vercel.app/api/metis/token/balances","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"owner":{"type":"string"},"contractAddresses":{"type":"array","items":{"type":"string"}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2jFPlXA7hZfF1ZbF6hhBt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches ERC-20 and native token balances for a given wallet address on the Metis network, optionally filtered by contract addresses","exampleAgentPrompt":"What tokens does the wallet 0xAbC123...def456 hold on the Metis network? Also check the balance for contract 0xToken1...abc and 0xToken2...xyz.","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Can you pull all the token balances for my wallet 0x1234abcd...5678 on the Metis network so I can see my full on-chain portfolio?"},{"title":"Specific token holding verification","prompt":"Check whether wallet 0xDeFi...9876 holds any of these two tokens on Metis — contracts 0xAAA...111 and 0xBBB...222 — and tell me the exact amounts."},{"title":"Airdrop eligibility snapshot","prompt":"I need to know the token balances for address 0xSnap...4321 on Metis for these contract addresses 0xDrop...001 and 0xDrop...002 to determine if they qualify for an airdrop."}],"resultDescription":"Returns a list of token balances for the specified wallet owner on the Metis network, including token contract addresses, token symbols, decimals, and raw or formatted balance amounts for each held token (optionally scoped to specified contract addresses).","failureModes":["Invalid owner address format returns a 400 error","Non-existent or zero-balance wallet returns empty balance array","Invalid contract address in the array causes partial or full error response","Metis network node unavailability causes a 503 or timeout","Payment not included or insufficient USDC causes a 402 payment required error","Rate limiting or quota exceeded returns a 429 error"],"whenToPreferThis":"Choose this endpoint when you specifically need token balance data on the Metis Layer 2 network. It is ideal for DeFi portfolio aggregation, airdrop eligibility checks, on-chain balance verification, or any workflow requiring fast, pay-per-call access to Metis token holdings without spinning up your own node infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:49:55.437Z","isFirstParty":false}