1Shot API integration
1Shot API runs smart-contract transactions from server wallets it hosts on EVM chains. Configure contract methods from a contract address or ABI, simulate, estimate, read and execute them, transfer native tokens, list transactions and wallets, watch contract events and manage webhooks. Executing a method or a transfer spends real tokens from the wallet. Wallet deletion, signatures, Permit2, creating, redelegating or deleting delegations (listing them is exposed), batch and delegator execution, struct editing, prompt-based setup and x402 payments are not exposed. Authentication is an API key and secret (OAuth client credentials); business-scoped tools also take the business id, which the user reads on the Business Details page of the 1Shot API console.
Say what should happen.
The workflow builds itself.
What you can do with 1Shot API
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Endpoint, 5 operations
create_webhook_endpointCreate webhook endpointPOSTRegisters a URL to receive 1Shot webhooks. 1Shot signs each webhook with ED25519; the endpoint's publicKey verifies them.delete_webhook_endpointDelete webhook endpointDELETEDeletes a webhook endpoint; 1Shot stops sending webhooks to it.get_webhook_endpointGet webhook endpointGETReturns one webhook endpoint: destination URL, verification state, last ping and signature public key.list_webhook_endpointsList webhook endpointsGETLists the business's webhook endpoints with destination URL, verification state, last ping and the public key that verifies their signatures.update_webhook_endpointUpdate webhook endpointPUTRenames a webhook endpoint or changes its description; its destination URL cannot be changed. Returns the endpoint.
Event, 5 operations
create_contract_eventCreate contract eventPOSTCreates a new contract event definition for monitoring blockchain events.delete_contract_eventDelete contract eventDELETEDeletes a contract event definition. Nothing changes on chain.get_contract_eventGet contract eventGETReturns one contract event definition: chain, contract address, event name, topic hash and indexed topics.list_contract_eventsList contract eventsGETLists contract event definitions for a business with optional filtering.update_contract_eventUpdate contract eventPUTRenames a contract event definition or changes its description. Returns the definition.
Method, 5 operations
create_contract_methodCreate contract methodPOSTCreates a contract method: one function of a smart contract on a chain, with its inputs, outputs, state mutability and the wallet that pays for it. import_contract_abi creates one for every function of an ABI instead.delete_contract_methodDelete contract methodDELETEDeletes a contract method configuration. Nothing changes on chain.get_contract_methodGet contract methodGETReturns one contract method: chain, contract address, paying wallet, function name, inputs, outputs, state mutability and webhook settings.list_contract_methodsList contract methodsGETLists the business's contract methods (a smart-contract function configured with a chain, contract address and paying wallet), page by page, filterable by chain, name, status and contract.update_contract_methodUpdate contract methodPUTUpdates a contract method's chain, contract address, default wallet, name, description, function name, state mutability or webhook callback URL. Its inputs and outputs cannot be changed. Returns the method.
Trigger, 4 operations
create_webhook_triggerCreate webhook triggerPOSTCreates a webhook trigger: which events (eventNames, from list_webhook_event_names) and contract methods send webhooks to an endpoint.delete_webhook_triggerDelete webhook triggerDELETEDeletes a webhook trigger; its events stop sending webhooks.list_webhook_triggersList webhook triggersGETLists the business's webhook triggers: which events and contract methods send webhooks to which endpoint.update_webhook_triggerUpdate webhook triggerPUTChanges a webhook trigger's endpoint, events, contract methods, name or description. Returns the trigger.
Wallet, 4 operations
create_walletCreate walletPOSTCreates a server wallet for the business on one chain. 1Shot holds its keys; fund its address before executing contract methods from it.get_walletGet walletGETReturns one server wallet: its address, chain, name, low-balance threshold and, with includeBalances true, its native token balance.list_walletsList walletsGETLists the business's server wallets (one per chain each), with address, chain, name and balance details, page by page.update_walletUpdate walletPUTRenames a wallet or changes its description or low-balance alert threshold. Returns the wallet.
Transaction, 2 operations
get_transactionGet transactionGETReturns one transaction sent through 1Shot: status, transaction hash, method, wallet, fees, gas, memo, logs and failure reason.list_transactionsList transactionsGETLists the business's transactions (executions of contract methods and transfers) with status, hash, fees and memo, filterable by chain, status, wallet, method and creation time.
Webhook, 2 operations
list_endpoint_webhooksList endpoint webhooksGETLists all generated webhooks for a particular endpoint. Webhooks are generated by a Webhook Trigger, and delivery may be attempted multiple times.list_webhook_event_namesList webhook event namesGETLists the event names that can trigger webhooks, for create_webhook_trigger's eventNames.
Abi, 1 operation
import_contract_abiImport contract abiPOSTImports a complete ethereum ABI and creates Contract Methods for each "function" type entry. Every Contract Method will be associated with the same Wallet
Attempt, 1 operation
list_webhook_attemptsList webhook attemptsGETLists the delivery attempts of one webhook (status code, time, signature), page by page.
Chain, 1 operation
list_chainsList chainsGETLists the EVM chains 1Shot supports, with chain id, name, native currency and average block time.
Contract, 1 operation
check_contract_addressCheck contract addressGETReturns whether the address has contract bytecode on the given chain (`eth_getCode`) and, when the bytecode matches the EIP-7702 delegation designator (`0xef0100` + 20-byte implementation), the delegated implementation contract address.
Delegation, 1 operation
list_wallet_delegationsList wallet delegationsGETLists delegations for a wallet. Returns a paged response of delegations associated with the specified wallet.
Encode, 1 operation
encode_contract_methodEncode contract methodPOSTEncodes a contract method call with the given params into its transaction data (a hex string), without sending anything.
Estimate, 1 operation
estimate_contract_methodEstimate contract methodPOSTEstimates the gas amount and current fees for executing a contract method with the given params, without sending anything.
Execute, 1 operation
execute_contract_methodExecute contract methodPOSTSends a real blockchain transaction: runs a payable or nonpayable contract method from one of the business's server wallets, which pays the gas (and value, if set) in real tokens. Returns the Transaction; its status updates as it is mined.
Fee, 1 operation
get_chain_feesGet chain feesGETGets current gas fees and fee history for the specified chain. Returns either gasPrice for non-EIP-1559 chains (like Binance) or maxFeePerGas/maxPriorityFeePerGas plus nextBaseFeePerGas/history for EIP-1559 enabled chains.
Read, 1 operation
read_contract_methodRead contract methodPOSTCalls a view or pure contract method and returns its result; nothing is sent on chain. A lone boolean or number result can come back empty: simulate_contract_method returns any result. Errors on payable and nonpayable methods.
Search, 1 operation
search_contract_event_logsSearch contract event logsPOSTReads contract event logs from the blockchain for the specified event definition.
Test, 1 operation
simulate_contract_methodSimulate contract methodPOSTSimulates a contract method call without sending it: no gas is spent and nothing changes on chain. Tells whether the execution would succeed and returns its result or error.
Transfer, 1 operation
transfer_native_tokenTransfer native tokenPOSTSends the chain's native token (for example ETH) from a server wallet to an address: a real, irreversible transfer of funds. Without transferAmount it sends as much of the balance as the gas leaves. Returns the Transaction.
Use 1Shot API from Claude Code, Cursor or Codex
Connect 1Shot API in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its 1Shot API operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect 1Shot API
- Create your workspace
Sign up free. Nothing to install.
- Connect 1Shot API once
Add your 1Shot API connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
1Shot API integration FAQ
What can you do with the 1Shot API integration?
LiveContext exposes 40 operations on 1Shot API, covering endpoint, event, method and trigger.
