Quote swap

POST

/v1/swaps/quote

Requires scope quotes:read.

Authorization

ApiKey

headerAuthorizationBearer <sk_test_ or sk_live_ key>

Your sk_live_ / sk_test_ API key

Request Body

application/json

body

chain*string

Only ethereum is routable for USDT/XAUT today.

Value in"ethereum""base""arbitrum""polygon""celo""optimism""plasma"

fromToken*string

Token being sold.

Value in"usdt""xaut"

toToken*string

Token being bought.

Value in"usdt""xaut"

amount*string

Amount of fromToken to sell, in token units (for example "100" USDT).

Match^\d+(\.\d{1,6})?$

Lengthlength <= 80

safeAddress*string

The Safe doing the swap.

Match^0x[0-9a-fA-F]{40}$

Response Body

200application/json

Swap quote

TypeScript Definitions

Use the response body type in TypeScript.

data*

status*number

success*boolean

400application/json

Malformed body, a chain the aggregator cannot route USDT/XAUT on (everything but ethereum), or an amount below the per-token minimum.

TypeScript Definitions

Use the response body type in TypeScript.

data*

status*number

success*boolean

401application/json

The Authorization header is missing, malformed, or the API key is unknown or revoked

TypeScript Definitions

Use the response body type in TypeScript.

data*

status*number

success*boolean

403application/json

The API key lacks the quotes:read scope

TypeScript Definitions

Use the response body type in TypeScript.

data*

status*number

success*boolean

409application/json

The wallet is under recovery, so swaps are blocked

TypeScript Definitions

Use the response body type in TypeScript.

data*

status*number

success*boolean

429application/json

The API key exceeded its request budget for the window

TypeScript Definitions

Use the response body type in TypeScript.

data*

status*number

success*boolean

502application/json

The swap aggregator could not be reached or returned no route, or the chain's RPC node was unreachable

TypeScript Definitions

Use the response body type in TypeScript.

data*

status*number

success*boolean

Language

curl -X POST 'https://api.pilot.shiga.io/v1/swaps/quote' \
  -H 'Authorization: Bearer sk_test_...' \
  -H 'Content-Type: application/json' \
  -d '{
  "chain": "ethereum",
  "fromToken": "usdt",
  "toToken": "usdt",
  "amount": "string",
  "safeAddress": "string"
}'

curl -X POST 'https://api.pilot.shiga.io/v1/swaps/quote' \  -H 'Authorization: Bearer sk_test_...' \  -H 'Content-Type: application/json' \  -d '{  "chain": "ethereum",  "fromToken": "usdt",  "toToken": "usdt",  "amount": "string",  "safeAddress": "string"}'

Example ResponseSchema

{
  "data": {
    "chain": "ethereum",
    "moduleId": "evm_erc4337",
    "senderAddress": "string",
    "fromToken": "usdt",
    "toToken": "xaut",
    "amountIn": "string",
    "amountOut": "string",
    "minAmountOut": "string",
    "slippageBps": 100,
    "feeToken": "usdt",
    "gas": "string",
    "sponsored": false,
    "userCost": "string",
    "gasEstimated": true
  },
  "status": 200,
  "success": true
}

{  "data": {    "chain": "ethereum",    "moduleId": "evm_erc4337",    "senderAddress": "string",    "fromToken": "usdt",    "toToken": "xaut",    "amountIn": "string",    "amountOut": "string",    "minAmountOut": "string",    "slippageBps": 100,    "feeToken": "usdt",    "gas": "string",    "sponsored": false,    "userCost": "string",    "gasEstimated": true  },  "status": 200,  "success": true}

Quote swap

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response Body

Authorization

Request Body