Install the package
go get github.com/Fabric-Labs/polyester-sdk-go@v0.11.0Requires Go 1.26 or later. Realtime and on-chain Funding helpers are always included.
Source: Fabric-Labs/polyester-sdk-go.
Pin a version
The SDK is pre-1.0, so a minor release may change the API. Pin a git tag in production (example
above), not
@latest. Version v0.11.0 is the current API-key-only release. Breaking public API
changes are called out in the repository changelog.Testnet endpoints
The client does not target Testnet by default. Pass Environment: &polyester.TestnetEnvironment on every client:
| Setting | Value |
|---|---|
| API | https://api.testnet.polyester.com |
| WebSocket | wss://api.testnet.polyester.com |
Override with Config.APIURL / Config.WSURL. FromEnv selects Testnet only when POLYESTER_ENV=testnet is set, and reads optional POLYESTER_API_URL / POLYESTER_WS_URL overrides.
Verify the install
Public market data needs no credentials:
client, err := polyester.New(polyester.Config{
Environment: &polyester.TestnetEnvironment,
})
if err != nil { log.Fatal(err) }
defer client.Close()
ctx := context.Background()overview, err := client.MarketOverview.List(ctx, nil, 5, "", false)
if err != nil { log.Fatal(err) }
for _, market := range overview.Markets {
fmt.Println(market.Symbol, market.LastPrice.Ticks())
}If that prints a few markets, you are connected. Next: Quickstart.