{"uid":"cap_2Vl1oNdfN8MRkMd6D6Jy4","slug":"near-transfer-preflight-b0656c44","name":"NEAR Transfer Preflight","description":"Before sending a NEP-141 token on NEAR: is the token real and not paused, does the receiver exist, and is it registered on the token — the storage_deposit step whose absence fails a transfer. If not, says the exact fix and its NEAR cost. With from and amount, also checks the sender holds enough. Catches sending to the token contract itself. Live from the NEAR RPC.","url":"https://402.com.tr/api/x402/near-transfer-preflight?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["token","to"],"properties":{"to":{"type":"string","description":"Receiver NEAR account"},"from":{"type":"string","description":"Sender NEAR account (optional)"},"token":{"type":"string","description":"NEAR token contract account"},"amount":{"type":"string","description":"Amount in token units (optional)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_fwDmmnL_Z_9vLKS1QuaF-","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":"Validates a NEP-141 token transfer on NEAR before execution: checks token validity, receiver existence, storage registration, and optionally sender balance.","exampleAgentPrompt":"Before I send 500 USDT.near to alice.near, run a preflight check to make sure the token contract is valid, alice.near exists and is registered, and my account bob.near actually has enough balance — tell me exactly what needs to be fixed and how much NEAR it'll cost.","exampleUseCases":[{"title":"Pre-transfer storage registration check","prompt":"I want to send 1000 wrap.near tokens to charlie.testnet — can you check first if charlie.testnet is registered on the wrap.near contract and tell me what the storage deposit cost would be if not?"},{"title":"Sender balance sufficiency validation","prompt":"Before I send 250 META tokens from my account myagent.near to recipient.near, verify the token is real, the recipient exists and is registered, and that I actually have at least 250 META available."},{"title":"Diagnosing a failed transfer attempt","prompt":"My transfer of aurora token to newuser.near keeps failing — can you run a preflight check on the aurora token contract with receiver newuser.near and tell me exactly what's wrong and how to fix it?"}],"resultDescription":"Returns whether the token contract is valid and not paused, whether the receiver account exists on NEAR, whether the receiver is registered on the token contract (with exact NEAR storage deposit cost if not), and optionally whether the sender holds sufficient balance for the specified amount. Includes specific remediation steps and costs for any issues found.","failureModes":["Invalid or non-existent token contract account returns error indicating token is not real","NEAR RPC timeout or connectivity issues cause failed response","Malformed account IDs (wrong format) may return validation errors","Sending to token contract itself is flagged as a caught error condition","Missing required query params (token or to) returns schema validation error"],"whenToPreferThis":"Use this endpoint before any NEP-141 fungible token transfer on NEAR when you need to confirm the transfer will succeed without wasting gas or NEAR. It is the only preflight check that simultaneously validates token contract status, receiver existence, storage registration requirements, and optionally sender balance in a single call — saving agents from failed transactions and lost gas fees. Prefer this over manually querying NEAR RPC for each condition separately.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:43:26.389Z","isFirstParty":false,"canonicalSlug":"near-transfer-preflight-b0656c44"}