Calling the 1Shot API

Once you have funded an escrow wallet and configured a transaction, you can trigger the transaction by making a POST request to the 1Shot API. To do this you’ll need to generate a bearer token using your API key and secret.

Create an API key and secret by clicking the “API Keys” on the left-hand navigation bar in the 1Shot console. Click “Create New Key” and give it a name. This key will be active immediately and can be used to generate a bearer token. If you delete it, it will be permanently deactivated.

Generating a Bearer Token

1Shot API uses the machine-to-machine (M2M) flow for authentication. This means you’ll need to generate a bearer token to authenticate your requests.

You can generate a bearer token by making a POST request to api.1shotapi.com/v0/token with your API key and secret in the request body:

curl -X POST https://api.1shotapi.com/v0/token \
    -H "Content-Type: application/json" \
    -d '{"key": "my-key", "secret": "secret-key"}'

This will return a JWT bearer token that you can use to authenticate your requests to the 1Shot API. You can drop it into JWT.io to inspect the payload.

The bearer token expires after 1 hour, after which you’ll need to generate a new one.

Triggering a Transaction

It is now time to hit the chain! You will trigger a transaction by making a POST request to https://api.1shotapi.com/v0/transactions/{TRANSACTION_ENDPOINT_ID}/execute with your JWT. The call will look like this:

# Transfer 1 ERC-20 token to address 0xE936e8FAf4A5655469182A49a505055B71C17604 would look something like this
curl -X POST https://api.1shotapi.com/v0/transactions/{TRANSACTION_ENDPOINT_ID}/execute \
    -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"params": {"to": "0xE936e8FAf4A5655469182A49a505055B71C17604", "value": "1000000000000000000"}}' | jq .

where the JSON object under params is the input data you configured your transaction endpoint to accept and TRANSACTION_ENDPOINT_ID is the ID of the transaction endpoint you want to call. The USDC example from the transactions page would have the same payload structure as this.