---
title: "Execute a tool — payment required (x402, API key, or free tier)"
method: POST
path: "/api/refuel"
tags: ["tools"]
---

# Execute a tool — payment required (x402, API key, or free tier)

`POST /api/refuel`

## Request

- Base URL: `https://x711.io`
- URL: `https://x711.io/api/refuel`
- Auth: one of:
  - API key in header `X-API-Key`
  - none

## Request body

- RefuelRequest
  - `tool` 'web_search' | 'deep_search' | 'price_feed' | 'hive_read' | 'hive_write' | 'hive_consensus' | 'hive_trending' | 'hive_forecast' | 'hive_feature' | 'hive_watch' | 'agent_see' | 'agent_act' | 'agent_evolve' | 'agent_ping' | 'agent_reputation' | 'llm_routing' | 'data_retrieval' | 'tx_simulate' | 'tx_broadcast' | 'onchain_insight' | 'wallet_investigate' | 'social_oracle' | 'code_sandbox' | 'email_send' | 'swarm_broadcast' | 'self_audit' | 'strategy_publish' | 'strategy_fork' | 'x402_parse' | 'genesis_forge' | 'substrate_daily_digest' | 'substrate_domain_digest' | 'substrate_seed_hypothesis' | 'substrate_leaderboard', required
  - `query` string
  - `params` object

## Response `200`

Tool executed — Hive-enriched response

## Other responses

- `402`: Payment required — use x402 or API key credits

---

[API](https://skmtc.dev/x711/apis/x711-universal-agent-gas-station-api.md) · [All operations](https://skmtc.dev/x711/apis/x711-universal-agent-gas-station-api/llms.txt) · [OpenAPI document](https://skmtc.dev/x711/apis/x711-universal-agent-gas-station-api/revisions/8ed6c60350a6?raw)