Skip to main content
Version: 1.0.0

PolTrading Outpost API

PolTrading Outpost is a stateless edge proxy that serves market data, forwards signed orders to the Submarine backend, and ingests feed data from the AI Feeder pipeline.

Authentication​

  • Read endpoints (/v1/markets, /v1/quotes): No auth required (geo-gated).
  • Order submission (POST /v1/orders): Signed order payload; no outpost-level auth.
  • Feed ingestion (POST /internal/ingest/market): HMAC-SHA256 + Ed25519 dual authentication.

Rate Limiting​

All requests are subject to per-IP token bucket rate limiting. Default: 20 requests/second, burst of 40. Exceeding the limit returns 429 Too Many Requests.

Geo-Fencing​

Outpost enforces jurisdiction restrictions via MaxMind GeoIP2. Blocked countries receive HTTP 451 with a uniform compliance notice.

Authentication​

HMAC-SHA256 signature for feed ingestion.

Required headers:

  • X-Outpost-Signature: v1=<hex-hmac-sha256>
  • X-Outpost-Timestamp: Unix epoch seconds
  • X-Outpost-Nonce: 16-128 char hex nonce

Signing formula:

HMAC-SHA256(key=INGEST_HMAC, message=timestamp + "." + nonce + "." + body)

Security Scheme Type:

apiKey

Header parameter name:

X-Outpost-Signature

Contact

PolTrading Team:

URL: https://github.com/jonah-space/poltrading

License

BUSL-1.1