Skip to main content
POST
/
fast-fill
cURL
curl --request POST \
  --url https://api.relay.link/fast-fill \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "requestId": "<string>"
}
'
const options = {
method: 'POST',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({requestId: '<string>'})
};

fetch('https://api.relay.link/fast-fill', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
import requests

url = "https://api.relay.link/fast-fill"

payload = { "requestId": "<string>" }
headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
{
  "message": "Request successfully queued for fast fill."
}
{
"message": "Currency is required and could not be determined."
}
{
"message": "Unauthorized: Check API Key"
}
{
"message": "Forbidden: Fast fill requires a sponsoring wallet with app balance."
}
{
"message": "Request not found"
}
{
"message": "Conflict: This request is already being processed."
}
{
"message": "An internal server error occurred."
}

Headers

x-api-key
string
required

Required API key for authentication. Contact the team for getting an API Key

Body

application/json
requestId
string
required

The request ID of the request that needs to be fast filled

solverInputCurrencyAmount
string

The input currency amount that the solver receives on origin

maxFillAmountUsd
number

Optional per-request USD limit. If the computed fill value exceeds this amount, the request is rejected. Must be lower than or equal to the app's available USDC balance.

Response

Request was successful. It was either queued or found to be already executed.

Request was successful. It was either queued or found to be already executed.

message
string
Example:

"Request successfully queued for fast fill."