curl --request POST \
  --url https://api.amm.flashnet.xyz/v1/hosts/register \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "feeRecipientPublicKey": "03abcdef0123456789abcdef0123456789abcdef0123456789abcdef01234567",
  "minFeeBps": 50,
  "namespace": "my-cool-exchange",
  "nonce": "550e8400-e29b-41d4-a716-446655440000",
  "signature": "3045022100a7e5d4f8b2c9a1e6f0d5b8c4a9e7f2d1c8b5a4e9f0d6c5b3a2e1d0c9b8a7f02201f2e3d4c5b6a7980e9f0a1b2c3d4e5f67889a0b1c2d3e4f5a6b7c8d9e0f1a2b3"
}'

{
  "message": "Host 'my-cool-exchange' registered successfully.",
  "namespace": "my-cool-exchange"
}

Hosts

Register Host

This endpoint allows integrators to register as hosts. Hosts earn a configurable fee amount from trades executed in pools deployed in their namespace.

Host Registration Process

Choose a unique namespace identifier (3-32 characters)
Configure fee amounts for both host and Flashnet
Provide a fee recipient public key for receiving earned fees
Sign the registration request with the corresponding private key

Fee Structure

Hosts specify a minimum fee they will accept (min_fee_bps)
When pools are created, they can use the minimum or a higher fee
Flashnet receives a configurable percentage of any host fee charged (default 60%)
The host receives the remaining percentage

Example (with default 60% Flashnet split)

Host registers with min_fee_bps = 50 (0.5%)
Pool creator can use 50 BPS or higher
If pool uses 50 BPS: Flashnet gets 30 BPS, Host gets 20 BPS
If pool uses 200 BPS: Flashnet gets 120 BPS, Host gets 80 BPS

Authentication

Requires a valid JWT bearer token. The host’s public key must match the fee_recipient_public_key in the request, the same key should sign the intent to register the host.

Security

The request must be signed with the private key of fee_recipient_public_key
Each request requires a unique nonce to prevent replay attacks
The namespace must be globally unique

Arguments

namespace - Unique identifier for the host (3-32 characters)
min_fee_bps - Minimum host fee in basis points (at least 10 BPS)
fee_recipient_public_key - Public key for receiving host fees
nonce - Unique value for replay protection
signature - Signature of the request

Returns

200 OK if host is registered successfully
400 Bad Request if validation fails or namespace is already taken
401 Unauthorized if authentication fails
500 Internal Server Error if registration cannot be completed

POST

hosts

curl --request POST \
  --url https://api.amm.flashnet.xyz/v1/hosts/register \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "feeRecipientPublicKey": "03abcdef0123456789abcdef0123456789abcdef0123456789abcdef01234567",
  "minFeeBps": 50,
  "namespace": "my-cool-exchange",
  "nonce": "550e8400-e29b-41d4-a716-446655440000",
  "signature": "3045022100a7e5d4f8b2c9a1e6f0d5b8c4a9e7f2d1c8b5a4e9f0d6c5b3a2e1d0c9b8a7f02201f2e3d4c5b6a7980e9f0a1b2c3d4e5f67889a0b1c2d3e4f5a6b7c8d9e0f1a2b3"
}'

{
  "message": "Host 'my-cool-exchange' registered successfully.",
  "namespace": "my-cool-exchange"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Host registration details including namespace, minimum fee, and authentication

Request body for registering a new host on the Flashnet AMM platform.

Hosts are integrators who can create and manage AMM pools, earning fees from trades. Registration requires configuring a minimum fee that the host will accept.

Response

Host registered successfully

Response returned after successfully registering a host.

Get Pool Integrator Fees

Withdraw Host Fees

Auth