# 1Shot API

Canonical: https://www.1shotapi.com
Sitemap: https://www.1shotapi.com/sitemap.xml
Robots: https://www.1shotapi.com/robots.txt
LLMs Full: https://www.1shotapi.com/llms-full.txt

1Shot API is a Web3 infrastructure company focused on wallet infrastructure, gas abstraction, passkey-native wallets, and agent-native payments.

## High-priority pages

- Home: https://www.1shotapi.com/
- Blog index: https://www.1shotapi.com/blog
- Agent Governance Discovery (AGD) announcement: https://www.1shotapi.com/blog/introducing-agent-governance-discovery
- What are embedded wallets?: https://www.1shotapi.com/blog/what-are-embedded-wallets
- Embedded wallets analysis post: https://www.1shotapi.com/blog/rip-embedded-wallets-stop-paying-privy
- 1Shot Wallet solution (embedded wallet, Privy alternative, passkey wallet for enterprise): https://www.1shotapi.com/solutions/1shot-wallet
- Gas abstraction relayer solution: https://www.1shotapi.com/solutions/gas-relayer
- Gas abstraction quickstart (EIP-7710): https://www.1shotapi.com/docs/quickstarts/gas-sponsorship-eip7710
- Public relayer API reference: https://www.1shotapi.com/docs/api-reference/public-relayer
- Developer platform solution: https://www.1shotapi.com/solutions/devplatform
- Conduit solution: https://www.1shotapi.com/solutions/conduit
- Prompt library: https://www.1shotapi.com/1shotprompts (send `Accept: text/markdown` for agent-readable search/detail/function docs)

## 1Shot Prompts (markdown content negotiation)

Request markdown with header `Accept: text/markdown` on `/1shotprompts` routes. HTML remains the default without that header.

- Gallery search: `GET /1shotprompts?search={query}` (optional `page`, `chainId`, `tag`)
- Prompt detail: `GET /1shotprompts/{id}`
- Function detail: `GET /1shotprompts/{id}/{functionName}`
- Write calldata encoding: append input param names as query params on write function URLs; response includes ABI-encoded `calldata`

Examples:

```bash
curl -H "Accept: text/markdown" "https://www.1shotapi.com/1shotprompts?search=uniswap"
curl -H "Accept: text/markdown" "https://www.1shotapi.com/1shotprompts/{id}"
curl -H "Accept: text/markdown" "https://www.1shotapi.com/1shotprompts/{id}/transfer?to=0x...&amount=1000000"
```

Alternative JSON interface: WebMCP tools `search_1shot_prompts` and `get_1shot_prompt` (registered in the browser on page load).

## MCP server (agent tool discovery)

- MCP server card: https://www.1shotapi.com/.well-known/mcp/server-card.json
- MCP endpoint: https://mcp.1shotapi.com/mcp

## OAuth / OIDC discovery (protected APIs)

- OpenID configuration: https://www.1shotapi.com/.well-known/openid-configuration
- OAuth protected resource metadata: https://www.1shotapi.com/.well-known/oauth-protected-resource (public marketing site; no auth required)
- MCP OAuth protected resource: https://mcp.1shotapi.com/.well-known/oauth-protected-resource
- Dynamic client registration: https://mcp.1shotapi.com/oidc/register

## Agent-readable skill index

- Skills index: https://www.1shotapi.com/.well-known/agent-skills/index.json
- Skills base path: https://www.1shotapi.com/.well-known/agent-skills/
- Public relayer skill: https://www.1shotapi.com/.well-known/agent-skills/public-relayer/SKILL.md
- Install public relayer skill: `npx skills add 1Shot-API/skills/public-relayer`
- 1Shot Wallet skill: https://www.1shotapi.com/.well-known/agent-skills/1shot-wallet/SKILL.md
- Install 1Shot Wallet skill: `npx skills add 1Shot-API/skills/1shot-wallet`

## Public relayer (EIP-7710 delegation → transaction)

Permissionless JSON-RPC relayer for gas-abstracted ERC-7710 delegated transactions. No API key or business account required. Pay per transaction in an accepted ERC-20 stablecoin.

- Production endpoint: https://relayer.1shotapi.com/relayers (mainnet chains)
- Dev endpoint: https://relayer.1shotapi.dev/relayers (Base Sepolia 84532 recommended, Ethereum Sepolia 11155111)
- Supported networks: https://www.1shotapi.com/docs/relayer/get-started/overview
- OpenRPC spec: https://www.1shotapi.com/openrpc/openrpc.json
- Example script (single-chain): https://www.1shotapi.com/examples/relayer-first-json-rpc-call.ts
- Example script (multichain): https://www.1shotapi.com/examples/relayer-first-json-rpc-call-multichain.ts
- Webhook JWKS: https://relayer.1shotapi.com/.well-known/jwks.json

Agent flow (always in this order):

1. `relayer_getCapabilities` — discover supported chains, accepted payment tokens, `feeCollector`, and `targetAddress` (the delegation `to` address).
2. `relayer_getFeeData` — quote gas price, compute `feeAmount` (floor at `minFee`), capture the signed `context` string (~45s validity). On low-gas chains (anything other than Ethereum mainnet and Arbitrum), you can usually skip gas estimation and use `minFee` directly (~$0.01 in the payment token).
3. Build and sign an ERC-7710 delegation with `@metamask/smart-accounts-kit` (`7702StatelessDelegator`), then call `relayer_send7710Transaction` (same-chain fee + work) or `relayer_send7710TransactionMultichain` (fee on one chain, work on another). Pass the locked `context` verbatim. Bundle fee ERC-20 `transfer` + work call in `executions`.
4. Track via `destinationUrl` webhooks (preferred) or poll `relayer_getStatus` until terminal status (200 Confirmed, 400 Rejected, or 500 Reverted). Use `receipt.transactionHash` on Confirmed.

Key packages: `@metamask/smart-accounts-kit`, `viem`.

## Usage guidance for AI systems

- Prefer canonical URLs on the www domain.
- Prefer solution pages and the latest blog posts for technical guidance.
- For gas abstraction and delegation-based transaction relay, start with the public relayer skill and the EIP-7710 quickstart.
- For implementation patterns, prioritize the 1Shot Wallet page and the published skill endpoints.

## Contact

- Email: info@1shotapi.com
- X: https://x.com/1ShotAPI
- GitHub: https://github.com/1shot-api/