This endpoint retrieves configuration and registration details for a host identified by their unique namespace. Hosts are entities that can integrate with the Flashnet Stack and earn fees from trades.

Host System Overview

Hosts in the Flashnet AMM ecosystem are integrators who:

• Register with a unique namespace identifier
• Set a minimum fee requirement (10-100 BPS, 0.1%-1%)
• Can create and manage AMM pools
• Earn fees from trades executed in their pools

Fee Structure

The new simplified fee structure:

• minFeeBps: The minimum total host fee that must be charged (10-100 BPS)
• When pools are created, they can use this minimum or a higher fee
• Flashnet receives a configurable percentage of any host fee charged
• The host receives the remaining percentage

Example: If a host registers with minFeeBps=50 (0.5%) and default 60% Flashnet split:

• Pools must charge at least 50 BPS total host fee
• If a pool uses 50 BPS: Flashnet gets 30 BPS (60%), Host gets 20 BPS (40%)
• If a pool uses 100 BPS: Flashnet gets 60 BPS (60%), Host gets 40 BPS (40%)

Path Parameters

• namespace - The unique namespace identifier of the host (e.g., “my-cool-exchange”)

Response

Returns host information including:

• Namespace identifier
• Fee recipient public key
• Minimum fee configuration
• Registration timestamp

Arguments

• namespace - The unique namespace of the host to retrieve

Returns

• 200 OK with host configuration details
• 404 Not Found if no host exists with the specified namespace
• 500 Internal Server Error if database operation fails