{"openapi":"3.1.0","info":{"title":"NEAR View API","version":"1.0.0","description":"Execute read-only contract view methods on NEAR, live, via public NEAR RPC — no key. This is NEAR's equivalent of an eth_call: run any contract's view method against the current chain state and get its return value, with no transaction, gas or signer. Call a method by name with JSON arguments on any contract, or use the convenience endpoints for a NEP-141 fungible token's metadata and total supply and for any account's token balance. Read whatever a NEAR contract exposes — token data, AMM pool reserves, registry lookups, DAO and staking state — straight from the source, with the byte result decoded from JSON for you. The on-chain read layer every NEAR wallet, dashboard, trading bot and indexer needs. Live from the chain; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nearview-api","description":"oanor gateway"}],"tags":[{"name":"NEAR"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/balance":{"get":{"operationId":"get_v1_balance","tags":["NEAR"],"summary":"An account's NEP-141 token balance","description":"","parameters":[{"name":"contract","in":"query","required":true,"description":"Token contract account","schema":{"type":"string"},"example":"usdt.tether-token.near"},{"name":"account","in":"query","required":true,"description":"Holder account id","schema":{"type":"string"},"example":"token.sweat"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"An account's NEP-141 token balance (ft_balance_of). balance is the raw integer; ui_balance applies the token's decimals.","source":"public NEAR JSON-RPC (call_function)","symbol":"USDt","account":"token.sweat","balance":"52275087","contract":"usdt.tether-token.near","decimals":6,"ui_balance":52.275087},"meta":{"timestamp":"2026-06-14T08:03:57.926Z","request_id":"ee38af1d-bb36-4531-ac86-126b593e7356"},"status":"ok","message":"Balance retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/token":{"get":{"operationId":"get_v1_token","tags":["NEAR"],"summary":"NEP-141 token metadata + total supply","description":"","parameters":[{"name":"contract","in":"query","required":true,"description":"Token contract account","schema":{"type":"string"},"example":"usdt.tether-token.near"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"icon":"(data uri omitted)","name":"Tether USD","note":"NEP-141 fungible-token metadata (ft_metadata) and total supply (ft_total_supply). total_supply is the raw integer; divide by decimals.","spec":"ft-1.0.0","source":"public NEAR JSON-RPC (call_function)","symbol":"USDt","contract":"usdt.tether-token.near","decimals":6,"total_supply":"525944120793709"},"meta":{"timestamp":"2026-06-14T08:04:00.058Z","request_id":"5deaede7-5594-4bac-8521-508828b4c3c1"},"status":"ok","message":"Token retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/view":{"get":{"operationId":"get_v1_view","tags":["NEAR"],"summary":"Call any contract view method (read-only, like eth_call)","description":"","parameters":[{"name":"contract","in":"query","required":true,"description":"Contract account id","schema":{"type":"string"},"example":"usdt.tether-token.near"},{"name":"method","in":"query","required":true,"description":"View method name","schema":{"type":"string"},"example":"ft_metadata"},{"name":"args","in":"query","required":false,"description":"JSON arguments (default {})","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Return value of the contract view method, executed read-only at final block. The NEAR byte result is decoded from UTF-8 JSON for you.","method":"ft_metadata","result":{"icon":"data:image/svg+xml,%3Csvg width='111' height='90' viewBox='0 0 111 90' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath fill-rule='evenodd' clip-rule='evenodd' d='M24.4825 0.862305H88.0496C89.5663 0.862305 90.9675 1.64827 91.7239 2.92338L110.244 34.1419C111.204 35.7609 110.919 37.8043 109.549 39.1171L58.5729 87.9703C56.9216 89.5528 54.2652 89.5528 52.6139 87.9703L1.70699 39.1831C0.305262 37.8398 0.0427812 35.7367 1.07354 34.1077L20.8696 2.82322C21.6406 1.60483 23.0087 0.862305 24.4825 0.862305ZM79.8419 14.8003V23.5597H61.7343V29.6329C74.4518 30.2819 83.9934 32.9475 84.0642 36.1425L84.0638 42.803C83.993 45.998 74.4518 48.6635 61.7343 49.3125V64.2168H49.7105V49.3125C36.9929 48.6635 27.4513 45.998 27.3805 42.803L27.381 36.1425C27.4517 32.9475 36.9929 30.2819 49.7105 29.6329V23.5597H31.6028V14.8003H79.8419ZM55.7224 44.7367C69.2943 44.7367 80.6382 42.4827 83.4143 39.4727C81.0601 36.9202 72.5448 34.9114 61.7343 34.3597V40.7183C59.7966 40.8172 57.7852 40.8693 55.7224 40.8693C53.6595 40.8693 51.6481 40.8172 49.7105 40.7183V34.3597C38.8999 34.9114 30.3846 36.9202 28.0304 39.4727C30.8066 42.4827 42.1504 44.7367 55.7224 44.7367Z' fill='%23009393'/%3E%3C/svg%3E","name":"Tether USD","spec":"ft-1.0.0","symbol":"USDt","decimals":6},"source":"public NEAR JSON-RPC (call_function)","contract":"usdt.tether-token.near","block_height":202642523},"meta":{"timestamp":"2026-06-14T08:04:00.147Z","request_id":"76db6e5a-fc0d-44b7-9929-3e9a5cfe2a7e"},"status":"ok","message":"View call executed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata & live sample","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"symbol":"USDt","decimals":6},"source":"public NEAR JSON-RPC (query / call_function), keyless","service":"nearview-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/view":"Call any contract view method (contract=..., method=ft_metadata, args={...}).","GET /v1/token":"NEP-141 token metadata + total supply (contract=usdt.tether-token.near).","GET /v1/balance":"An account's NEP-141 token balance (contract, account)."},"description":"Execute read-only contract view methods on NEAR via public NEAR RPC — NEAR's equivalent of eth_call. Call any contract's view method with JSON args, or use the convenience endpoints for NEP-141 token metadata + total supply and an account's token balance. The on-chain read layer for NEAR wallets, dashboards and bots. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:00.269Z","request_id":"2e097026-fa05-43fa-83f3-567818974bb3"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6200,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1020,"monthly_call_quota":120000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3550,"monthly_call_quota":742000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":10100,"monthly_call_quota":4680000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nearview-api"}