Перейти к основному содержимому

FastNear API

FastNear API — это индексированное REST-семейство для продуктовых представлений аккаунтов. Это самый быстрый способ ответить на вопросы вроде «чем владеет этот аккаунт?» или «какие аккаунты соответствуют этому публичному ключу?» без сборки результата из сырых RPC-вызовов.

Лучше всего подходит для​

  • балансов кошельков и обзоров активов;
  • представлений аккаунта по NFT и FT-токенам;
  • поиска аккаунтов по публичному ключу;
  • объединённых снимков аккаунта для дашбордов, обозревателей и агентов.

Когда его не стоит использовать​

  • Используйте Справочник RPC, когда вам нужны канонические методы JSON-RPC из протокола.
  • Используйте Транзакции API, когда основная задача — история транзакций или квитанций.
  • Используйте NEAR Data API, когда вам нужен опрос данных по блокам и проверка свежести.

Базовые URL​

  • https://api.fastnear.com
  • https://test.api.fastnear.com

Аутентификация и доступность по сетям​

  • Публичные REST-эндпоинты FastNear не требуют API-ключа.
  • Интерфейс документации всё равно может передавать необязательный ключ FastNear, если вам нужно аутентифицированное поведение или повышенные лимиты на поддерживаемых поверхностях.
  • Добавьте ?network=testnet, чтобы переключить совместимые страницы на testnet-бэкенд и подготовленные значения по умолчанию для testnet.

С чего обычно начинают​

  • V1 полный снимок аккаунта — для объединённого снимка аккаунта.
  • V1 FT-токены аккаунта и V1 NFT аккаунта — для продуктовых представлений активов.
  • V1 поиск по публичному ключу — когда нужно определить аккаунт по ключу.
  • V1 топ держателей FT — для представлений распределения токенов.

Устранение неполадок​

Мне нужно только одно низкоуровневое значение из состояния цепочки​

Используйте сырой RPC. Эта индексированная поверхность оптимизирована для продуктовых представлений, а не для зеркального повторения каждого RPC-метода.

Страница всё ещё показывает данные mainnet​

Проверьте, поддерживает ли страница ?network=testnet. Некоторые сценарии работают только с mainnet, и документация явно отмечает такие случаи.

Мне нужны транзакции, а не балансы​

Переходите в Транзакции API, чтобы не перегружать поверхность представления аккаунта запросами по истории.