Skip to content

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Saymon RU Data API

🇷🇺 Российские данные для AI-агентов · 🇨🇳 面向AI代理的俄罗斯数据API · 🇯🇵 AIエージェント向けロシア語データAPI · 🇰🇷 AI 에이전트를 위한 러시아어 데이터 API

The only legal window into the Russian market for AI agents. Russian-language (Runet) data: state-registry company checks, Runet search, Russian Post delivery, CBR/MOEX market data. Pay per request in USDC via x402 (HTTP 402 Payment Required). No API keys, no accounts, no subscriptions.

Base URL: https://payforapi.com · MCP: https://payforapi.com/mcp · Health: https://payforapi.com/health · Manifest: https://payforapi.com/.well-known/x402.json

Network: Base mainnet (eip155:8453) · Asset: USDC · Facilitator: https://facilitator.payai.network

Endpoints (22)

Endpoint Price Description
POST /v1/inn-lookup $0.01 Russian company check by INN — official EGRUL state registry, unavailable to foreign checkers (merchant KYB before a deal).
POST /v1/fns-npd-check $0.01 RU self-employed (NPD) status by INN via FNS. Run before paying a contractor.
POST /v1/ru-search $0.02 Runet search (Russian-language internet) via Yandex — products, prices, sellers, reviews English engines miss. The only legal window into the Russian market.
POST /v1/web-search $0.02 Global web search (Tavily) — the Western half of the pair with Runet search: sources the runet lacks.
POST /v1/ru-page $0.01 Clean Russian-language page → LLM-ready Markdown (trafilatura): product card, store, news.
POST /v1/research $0.02 Runet dossier: search + top pages in one Markdown report — seller, product, company.
POST /v1/research/deep $0.05 Deep Runet dossier: 3 searches + up to 10 pages — RU courts, media, registries. Vet before a large order.
POST /v1/company-report $0.05 KYB dossier in one payment: official EGRUL check + NPD status + deep Runet dossier — 3 services for the price of the dossier (vs $0.07 retail).
POST /v1/ru-search/x10 $0.18 Bulk Runet search: up to 10 queries in one payment (10% off vs single calls).
POST /v1/ru-search/x100 $1.60 Bulk Runet search: up to 100 queries in one payment (20% off) — catalogs, suppliers, price monitoring.
POST /v1/pochta-tariff $0.01 Russian Post: delivery cost between postcodes (official API) — shipping math for checkout.
POST /v1/pochta-track $0.01 Russian Post: parcel tracking by track number (SOAP) — the only legal RU tracking.
POST /v1/pochta-delivery-time $0.01 Russian Post: control delivery times between postcodes (days).
POST /v1/pochta-offices $0.01 Russian Post: offices by postcode or coordinates — pickup points.
POST /v1/pochta-zip $0.01 Russian postal codes by address or office.
POST /v1/pochta-address $0.01 RU address normalization to Russian Post standard (index, region, street, house).
POST /v1/pochta-delivery $0.04 Russian Post delivery bundle: address + postcode + office + rate + time in one payment (5 services in 1).
POST /v1/ticker $0.005 Bybit spot crypto tickers: last price, 24h change, volume.
POST /v1/cbr-rates $0.008 Central Bank of Russia official daily FX rates (USD, EUR, CNY…) — state reference for RUB pricing.
POST /v1/moex-quote $0.008 Moscow Exchange quotes: stocks (SBER, GAZP…), FX pairs, indices (IMOEX) — live Russian market data.
POST /v1/chat/gpt-5.6-sol $0.02 LLM chat: OpenAI gpt-5.6-sol reasoning model, pay per call.
POST /v1/chat/claude-opus-5 $0.05 LLM chat: Anthropic claude-opus-5 reasoning model, pay per call.

Examples

# 1. Unpaid request -> 402 Payment Required
curl -X POST https://payforapi.com/v1/inn-lookup \
  -H "Content-Type: application/json" -d '{"inn": "7707083893"}'

# 2. Sign EIP-3009 transferWithAuthorization for USDC (Base) to payTo from the 402 response
# 3. Resend with PAYMENT-SIGNATURE header -> 200 OK + payment-response

MCP

Remote MCP server (streamable-http): https://payforapi.com/mcp — 17 tools: inn_lookup, ru_search, ru_page, ru_research, ru_research_deep, company_report, cbr_rates, moex_quote, pochta_tariff, pochta_track, pochta_delivery_time, pochta_offices, pochta_zip, pochta_address, pochta_delivery, gpt_5_6_sol_chat, claude_opus_5_chat. Agents pay via _meta["x402/payment"].

中文 (Chinese)

面向AI代理的俄罗斯数据API。按次付费(x402 / HTTP 402),Base链USDC结算。无需注册、无需API密钥、无订阅。

  • 企业核实POST /v1/inn-lookup($0.01)— 通过ИНН查询俄罗斯企业(ЕГРЮЛ/ФНС官方数据):ОГРН、КПП、负责人、注册日期、地区
  • 个体户(НПД)状态核实POST /v1/fns-npd-check($0.01)
  • 俄语搜索POST /v1/ru-search($0.02)· 全球搜索 web-search($0.02)
  • 俄语网页转MarkdownPOST /v1/ru-page($0.01)
  • 研究包POST /v1/research($0.02)· POST /v1/research/deep($0.05)— 供应商/客户尽调
  • KYB尽调包POST /v1/company-report($0.05)— ЕГРЮЛ核实+НПД状态+深度俄网报告
  • 批量俄语搜索POST /v1/ru-search/x10($0.18)· POST /v1/ru-search/x100($1.60)
  • 俄罗斯邮政POST /v1/pochta-track($0.01,包裹跟踪)· pochta-tariff · pochta-delivery-time · pochta-offices · pochta-zip · pochta-address(各$0.01)· 投递包 pochta-delivery($0.04,5合1)
  • 金融数据cbr-rates(央行汇率,$0.008)· moex-quote(莫斯科交易所报价,$0.008)· ticker(加密货币,$0.005)
  • LLM对话chat/gpt-5.6-sol($0.02)· chat/claude-opus-5($0.05)

中俄贸易背景下的应用:进口商/出口商在交易前核验俄方企业真实性,物流团队跟踪俄罗斯邮政包裹(17TRACK等免费平台无API接口,本服务提供按次计费的机器可读API)。

日本語 (Japanese)

AIエージェント向けロシア語データAPI。x402(HTTP 402)従量課金、BaseチェーンUSDC。APIキー・アカウント・サブスク不要。

  • 法人照会POST /v1/inn-lookup($0.01)— ИННによるロシア法人確認(ЕГРЮЛ/ФНС公式データ)
  • 個人事業主(НПД)確認POST /v1/fns-npd-check($0.01)
  • ロシア語検索POST /v1/ru-search($0.02)· グローバル検索 web-search($0.02)
  • ページ変換POST /v1/ru-page($0.01)— LLM対応Markdown
  • リサーチPOST /v1/research($0.02)· /v1/research/deep($0.05)
  • KYBパックPOST /v1/company-report($0.05)— 法人確認+НПД+ロシア語ディープ調査を一括
  • 一括ロシア語検索POST /v1/ru-search/x10($0.18)· /v1/ru-search/x100($1.60)
  • ロシア郵便POST /v1/pochta-track($0.01,追跡)ほか5エンドポイント(各$0.01)· 配送バンドル pochta-delivery($0.04,5in1)
  • 金融データcbr-rates(中央銀行為替,$0.008)· moex-quote(モスクワ取引所,$0.008)· ticker(仮想通貨,$0.005)
  • LLMチャットchat/gpt-5.6-sol($0.02)· chat/claude-opus-5($0.05)

한국어 (Korean)

AI 에이전트를 위한 러시아어 데이터 API. x402(HTTP 402) 종량제, Base 체인 USDC 결제. API 키·계정·구독 불필요.

  • 법인 조회POST /v1/inn-lookup($0.01)— ИНН으로 러시아 법인 확인(ЕГРЮЛ/ФНС 공식 데이터)
  • 자영업자(НПД) 확인POST /v1/fns-npd-check($0.01)
  • 러시아어 검색POST /v1/ru-search($0.02)· 글로벌 검색 web-search($0.02)
  • 페이지 변환POST /v1/ru-page($0.01)— LLM용 Markdown
  • 리서치POST /v1/research($0.02)· /v1/research/deep($0.05)
  • KYB 패키지POST /v1/company-report($0.05)— 법인확인+НПД+러시아어 딥 리포트 일괄
  • 일괄 러시아어 검색POST /v1/ru-search/x10($0.18)· /v1/ru-search/x100($1.60)
  • 러시아 우체국POST /v1/pochta-track($0.01,배송 추적)외 5개 엔드포인트(각 $0.01)· 배송 번들 pochta-delivery($0.04,5in1)
  • 금융 데이터cbr-rates(러시아 중앙은행 환율, $0.008)· moex-quote(모스크바 거래소, $0.008)· ticker(암호화폐, $0.005)
  • LLM 채팅chat/gpt-5.6-sol($0.02)· chat/claude-opus-5($0.05)

Why

  • Only Cyrillic/RU-native segment in the x402 ecosystem: EGRUL verification, Russian web search, RU scraping, Russian Post tracking, CBR FX, MOEX quotes.
  • Keyless for clients: no registration, no API keys — wallet pays, agent gets data.
  • Official sources (EGRUL/FNS, Russian Post, CBR, MOEX), legal for resale (129-ФЗ, 262-ФЗ, 44-ФЗ).

Docs & manifest

  • llms.txt — machine-readable description for LLMs (EN/中文/日本語/한국어 sections)
  • /.well-known/x402.json — x402 discovery manifest (i18n: ru/en/zh/ja/ko)
  • /openapi.json — OpenAPI spec

© 2026 Saymon / Real Energy.

About

Saymon RU Data API — Russian-language data endpoints for AI agents: EGRUL/INN company check, Cyrillic search, research, Russian Post tracking. Pay-per-call via x402 in USDC (Base). 🌏 EN/中文/日本語/한국어

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors