# BGPTree

> High-performance BGP Autonomous System Number (ASN) intelligence, global routing telemetry, and interactive multi-hop interconnectivity topology explorer. Developed and maintained by SystGrid Solutions Pvt Ltd (Mumbai, India).

## Overview

BGPTree (https://bgptree.com) provides real-time and cached BGP routing table intelligence for autonomous systems across global IPv4 and IPv6 backbones. It correlates upstream transit providers, lateral peering relationships, downstream customers, announced IP prefixes, Internet Exchange Point (IXP) colocation fabrics, and RIPE Atlas telemetry probes into high-performance graph visualizations and machine-readable APIs.

- **Operator**: SystGrid Solutions Pvt Ltd (https://systgrid.com)
- **Headquarters & Jurisdiction**: Mumbai, Maharashtra, INDIA
- **Compliance**: DPDP Act 2023 (Digital Personal Data Protection Act, India), CERT-In regulatory compliance
- **Primary Web URL**: https://bgptree.com
- **API Base URL**: https://api.bgptree.com/api/v1

## Core Mission

The Border Gateway Protocol (BGP) is the routing foundation of the global Internet. BGPTree demystifies global routing tables and peering interconnects by providing:
1. Instant lookup and telemetry for any 16-bit or 32-bit Autonomous System Number (ASN).
2. Protocol-isolated topology views for IPv4, IPv6, and dual-stack backbones.
3. Multi-hop propagation path tracing and recursive neighbor graph expansion.
4. Comprehensive colocation and peering intelligence across global IXP facilities.
5. High-speed, rate-controlled programmatic access for AI agents, security researchers, and network engineering tools.

## URL Patterns & Web Navigation

- `https://bgptree.com/`: Global search console, system directory, and interactive BGP topology explorer.
- `https://bgptree.com/as/:asn`: Comprehensive intelligence dossier for a specific Autonomous System (e.g. `/as/132986`, `/as/13335`, `/as/15169`). Displays operator identity, RIR registry, IPv4/IPv6 announced prefixes, upstream transit providers, direct peers, downstream customers, and IXP presences.
- `https://bgptree.com/as/:asn/graph`: Full-screen, interactive 2D Canvas/SVG and 3D WebGL multi-hop BGP propagation tree explorer with dynamic adjacency drill-down.
- `https://bgptree.com/terms`: Terms and Conditions governing usage, exclusive jurisdiction of Courts of Mumbai, Maharashtra, India, and lawful interception frameworks.
- `https://bgptree.com/privacy`: Privacy Policy detailing data handling and fiduciary obligations under the DPDP Act 2023.
- `https://bgptree.com/acknowledgements`: Upstream data source attributions, including RIPE NCC (RIPEstat RIS & Atlas), PeeringDB, CAIDA, and Regional Internet Registries (AFRINIC, APNIC, ARIN, LACNIC, RIPE NCC).

## API Integration (`https://api.bgptree.com/api/v1`)

BGPTree provides an enterprise REST API secured by short-lived cryptographic JSON Web Tokens (JWT). All requests are served over HTTPS with TLS 1.3 encryption.

### Authentication Flow
1. Obtain an ephemeral session token:
   `POST https://api.bgptree.com/api/v1/auth/session`
2. Include the returned token in the `Authorization` header on all protected requests:
   `Authorization: Bearer <token>`

### Core Endpoints
- `GET /health`: Health probe and MariaDB/Redis connectivity status (Public).
- `GET /version`: Current deployment version, Git commit hash, and legal ownership (Public).
- `GET /sources`: Attribution metadata for remote telemetry sources (Public).
- `POST /auth/session`: Issue an ephemeral JWT session token (Public).
- `GET /asn/{asn}`: Full ASN dossier, organization details, registry, and prefix counts (JWT Required).
- `GET /asn/{asn}/neighbors?proto={all|ipv4|ipv6}`: Direct BGP adjacencies categorized by transit, peer, or customer (JWT Required).
- `GET /asn/{asn}/ixps`: IXP facility presence, peering IPs, and speed capacities (JWT Required).
- `GET /asn/{asn}/tree?proto={ipv4|ipv6}`: Multi-hop BGP propagation tree and tier-1 hierarchy (JWT Required).
- `GET /asn/{asn}/probes`: Real-time RIPE Atlas probe availability within the network (JWT Required).
- `GET /search?q={query}`: Instant prefix and operator search by ASN or name (JWT Required).
- `POST /graph/expand`: Dynamic multi-hop graph expansion for visualization nodes (JWT Required).

## Machine Specifications & Further Reading

- [Full LLMs Specification](https://bgptree.com/llms-full.txt): Comprehensive API guide, complete curl command examples, JSON schema shapes, and rate-limiting limits.
- [AI Plugin Manifest](https://bgptree.com/.well-known/ai-plugin.json): OpenAI and LangChain compatible AI plugin specification.
- [OpenAPI 3.1 Specification](https://api.bgptree.com/api/v1/openapi.json): Standard OpenAPI contract for automated client generation.