POST
/
v1
/
hosts
/
register
Register Host
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.

namespace
string
required

Unique namespace identifier for the host. Must be between 3-32 characters and globally unique.

Example:

"my-cool-exchange"

minFeeBps
integer
required

Minimum host fee in basis points (BPS). This is the minimum fee that must be charged when using this host's namespace. Must be between 10-100 BPS (0.1% - 1%). Flashnet receives a configurable percentage of any host fee charged (default 60%). 1 BPS = 0.01%, so 100 BPS = 1%.

Example:

50

feeRecipientPublicKey
string
required

Public key that will receive the host's share of trading fees. Must be a valid secp256k1 public key.

Example:

"03abcdef0123456789abcdef0123456789abcdef0123456789abcdef01234567"

nonce
string
required

Unique nonce for replay protection. Each request must use a unique nonce.

Example:

"550e8400-e29b-41d4-a716-446655440000"

signature
string
required

Hex-encoded secp256k1 signature of the request. Must be signed by the private key corresponding to fee_recipient_public_key.

Example:

"3045022100a7e5d4f8b2c9a1e6f0d5b8c4a9e7f2d1c8b5a4e9f0d6c5b3a2e1d0c9b8a7f02201f2e3d4c5b6a7980e9f0a1b2c3d4e5f67889a0b1c2d3e4f5a6b7c8d9e0f1a2b3"

Response

Host registered successfully

Response returned after successfully registering a host.

namespace
string
required

The registered namespace identifier.

Example:

"my-cool-exchange"

message
string
required

Human-readable confirmation message.

Example:

"Host 'my-cool-exchange' registered successfully."