Skip to main content

​
Base URL

​
Authentication

Most endpoints require your owner wallet address as a query parameter. The Float MCP handles this automatically — you only need to authenticate manually if you’re calling the API directly.
Agent-specific endpoints also require your agent’s API key as a Bearer token:
Your API key is written to ~/.float/config.json after running npx @usefloat/cli@latest init.

​
Response format

All responses are JSON. Errors follow this shape:
HTTP status codes:

​
Rate limits

The Float API does not currently enforce rate limits, but this will change as the platform scales. Be reasonable with polling intervals — use the status endpoint with a 2-second interval maximum during link session polling.

​
Endpoint groups

Agents

Provision, configure, and manage agents and their wallets.

Payments

Initiate payments and query payment history.

Services

Discover available paid APIs in Float’s service registry.