Skip to main content

​
Base URL

https://api.usefloat.xyz

​
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. 
GET /v1/dashboard?owner=<wallet-address>
Agent-specific endpoints also require your agent’s API key as a Bearer token: 
Authorization: Bearer float_sk_...
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: 
{
  "error": "Human-readable error message"
}
HTTP status codes:
CodeMeaning
200Success
400Bad request — check your parameters
401Unauthorized — missing or invalid API key
402Payment required (x402)
404Resource not found
409Conflict — e.g. agent ID already exists
500Internal server error

​
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.