Агенты на FastNear

Эта страница — для ИИ-агентов, краулеров и сред автоматизации, которым нужно работать с API FastNear или потреблять её документацию. Ниже перечислены поверхности, их базовые URL, способ аутентификации и способы получения чистого контекста документации для промптов.

Обзор сайта

FastNear предоставляет один канонический RPC и семейство индексированных REST API поверх протокола NEAR. Каждая поверхность ниже — это отдельный хост с собственной формой ответа; один и тот же API-ключ FastNear работает со всеми.

Поверхность	Базовые URL	Что здесь живёт
Справочник RPC	rpc.mainnet.fastnear.com, rpc.testnet.fastnear.com, архивные варианты	Канонический JSON-RPC: состояние аккаунта, блоки и чанки, view-вызовы контрактов, отправка транзакций, данные валидаторов и протокола.
FastNear API	api.fastnear.com, test.api.fastnear.com	Индексированные REST-представления балансов, NFT, FT-токенов, стейкинга, поиска по публичному ключу и объединённые снимки аккаунта.
Транзакции API	tx.main.fastnear.com, tx.test.fastnear.com	Индексированные запросы транзакций, квитанций, истории аккаунтов и истории блоков.
API переводов	transfers.main.fastnear.com	История переводов NEAR и FT-токенов по аккаунтам. Пока только mainnet.
NEAR Data API	mainnet.neardata.xyz, testnet.neardata.xyz	Кэшированные и архивные чтения по семействам блоков, опрос оптимистичных и финализированных блоков, вспомогательные перенаправления.
KV FastData API	kv.main.fastnear.com, kv.test.fastnear.com	Запросы только для чтения к данным «ключ–значение» поверх индексированной FastData.
Снапшоты	см. дочерние страницы	Готовые снапшоты для операторов, поднимающих RPC- или архивные ноды. Не путь для прикладных запросов.

У каждой поверхности есть своя индексная страница с полным списком операций, формами запросов и ответов и живыми примерами.

Направьте вопрос агента к одной поверхности

• «Какое состояние у этого аккаунта прямо сейчас?» → Справочник RPC (view_account, view_access_key).
• «Что принадлежит этому аккаунту — балансы, NFT, стейкинг?» → FastNear API.
• «Какая у аккаунта недавняя активность или история транзакций?» → Транзакции API.
• «Только события переводов?» → API переводов.
• «Что изменилось в самых свежих блоках?» → NEAR Data API.
• «История записей «ключ–значение» для контракта?» → KV FastData API.
• «Поднять инфраструктуру, а не запрашивать данные.» → Снапшоты.

Полная таблица решений с разбором компромиссов: Выбор подходящей поверхности.

Один ключ — все поверхности

Публичные эндпоинты работают и без ключа. Добавьте ключ, если нужны повышенные лимиты или платные сценарии. Один и тот же ключ работает со всеми поверхностями выше; передавайте его либо в HTTP-заголовке, либо в URL-параметре:

Заголовок Authorization

curl "https://rpc.mainnet.fastnear.com" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  --data '{"method":"block","params":{"finality":"final"},"id":1,"jsonrpc":"2.0"}'

URL-параметр

curl "https://rpc.mainnet.fastnear.com?apiKey=${API_KEY}"

Получить ключ: dashboard.fastnear.com. Операционный режим для неинтерактивных агентов: Аутентификация для агентов — ключи должны жить в переменных окружения или менеджере секретов, а не в браузерном хранилище, логах чатов или промптах. Полный сценарий и детали заголовков: Аутентификация и доступ.

Как вынимать чистую документацию в промпт

• На каждой странице в правом верхнем углу есть кнопка Копировать Markdown. Она отдаёт Markdown-версию страницы без навигации, пригодную для вставки в промпт или RAG-хранилище.
• Соглашение llms.txt поддерживается:
  • /llms.txt — индекс страниц и краткие описания.
  • /llms-full.txt — полный корпус документации в одном файле.
  • Русскоязычные аналоги: /ru/llms.txt и /ru/llms-full.txt.
• Машиночитаемая структура сайта для ингеста с учётом связей: /structured-data/site-graph.json (русский зеркал в /ru/).
• У каждой страницы есть Markdown-зеркало по тому же slug с суффиксом .md (например, /rpc.md, /api.md, /agents.md), если прямой запрос удобнее кнопки «Копировать Markdown».

Подсказки на каждый вызов

• Имена параметров, поля ответа и примеры пэйлоадов отрисовываются на каждой странице эндпоинта в реальном времени. Первоисточник — реестр src/data/generatedFastnearPageModels.json; используйте его, если зеркалите схему в другой системе.
• ?network=testnet поддерживается только на конкретных страницах. Каждая страница отмечает поддержку сетей в разделе Аутентификация и доступность; не считайте, что переключение работает везде.
• Токены пагинации (resume_token, page_token) непрозрачны. Используйте их ровно в том виде, в котором получили, и только с тем же эндпоинтом и фильтрами, что их вернули.
• В каждом REST-семействе есть маршруты /status и /health для проверки живости и задержки синхронизации.

Сценарии и подробные руководства

• Сценарии для агентов — сочетания поверхностей для исследования аккаунтов, расследования транзакций, мониторинга почти в реальном времени и поднятия инфраструктуры.
• Выбор подходящей поверхности — таблица решений с маршрутизацией по вопросу.
• Аутентификация для агентов — чек-лист работы с учётными данными.

Когда за агентом стоит человек-разработчик

Корневая страница выбора настроена на то, чтобы человек быстро выбрал первую поверхность. Направляйте туда людей, а эту страницу оставьте для программного потребления.