{"openapi":"3.0.0","info":{"title":"Fluid Wallet Agent API","version":"1.0.0","description":"API for AI agents to interact with Fluid Wallet — send, swap, and pay on Base."},"servers":[{"url":"https://fluidnative.com"}],"security":[{"AgentKey":[]}],"components":{"securitySchemes":{"AgentKey":{"type":"apiKey","in":"header","name":"X-Agent-Key","description":"Obtain at https://fluidnative.com/agentic-keys"}}},"paths":{"/v1/agents/me":{"get":{"summary":"Get identity of the key holder","operationId":"getMe","responses":{"200":{"description":"Key holder email and scopes"}}}},"/v1/agents/identity/resolve":{"get":{"summary":"Resolve email to wallet address","operationId":"resolveIdentity","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Wallet address for the given email"}}}},"/v1/agents/history":{"get":{"summary":"Recent transaction history","operationId":"getHistory","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Array of transactions"}}}},"/v1/agents/quote-swap":{"post":{"summary":"Get a swap price quote","operationId":"quoteSwap","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["fromToken","toToken","amount"],"properties":{"fromToken":{"type":"string"},"toToken":{"type":"string"},"amount":{"type":"string"},"chain":{"type":"string","default":"base"}}}}}},"responses":{"200":{"description":"Price quote"}}}},"/v1/agents/estimate-gas":{"post":{"summary":"Estimate gas for a send","operationId":"estimateGas","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["to","amount"],"properties":{"to":{"type":"string"},"amount":{"type":"string"},"token":{"type":"string"},"chain":{"type":"string"}}}}}},"responses":{"200":{"description":"Gas estimate in USD"}}}},"/v1/agents/send":{"post":{"summary":"Send ETH or tokens on-chain","operationId":"sendPayment","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["to","amount"],"properties":{"to":{"type":"string","description":"Recipient address or email"},"amount":{"type":"string"},"token":{"type":"string","default":"ETH"},"chain":{"type":"string","default":"base"}}}}}},"responses":{"200":{"description":"Payment queued"}}}},"/v1/agents/swap":{"post":{"summary":"Swap tokens via Fluid SOR","operationId":"executeSwap","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["fromToken","toToken","amount"],"properties":{"fromToken":{"type":"string"},"toToken":{"type":"string"},"amount":{"type":"string"},"slippage":{"type":"string","default":"0.5"}}}}}},"responses":{"200":{"description":"Swap queued"}}}},"/v1/agents/agent-pay":{"post":{"summary":"Pay another Fluid user by email","operationId":"agentPay","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["toEmail","amount"],"properties":{"toEmail":{"type":"string"},"amount":{"type":"string"},"token":{"type":"string","default":"USDC"},"memo":{"type":"string"}}}}}},"responses":{"200":{"description":"Agent-to-agent payment queued"}}}}}}