curl --request GET \
--url https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route \
--header 'x-api-key: <api-key>'import requests
url = "https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"disclaimer": "Research and information, not investment advice.",
"data": {
"vaultId": "pendle:1:0x5949c3bfdf9babd8bf011d9d8dbb1a2c3e10d8b8",
"chainId": 1,
"screened": true,
"verdict": "OK",
"reasonClass": "protocol_refused",
"usdIn": 5000,
"usdOut": 4991,
"retained": 0.9982,
"path": "pendle",
"probe": {
"scope": "same-chain",
"funding": "<string>",
"legs": "<string>",
"notionalsUsd": [
100,
5000
],
"router": {},
"crossChain": "not probed"
},
"checkedAt": "2023-11-07T05:31:56Z",
"cost": {
"notionalUsd": 10000,
"router": "lifi",
"gasBasis": "p50_7d",
"fixedUsd": {
"current": 123,
"p50_7d": 123,
"p90_7d": 123,
"floor": true
},
"gasUnits": {
"swap": 123,
"vaultEntry": 123,
"vaultExit": 123,
"approvals": 123,
"total": 123,
"vaultGasSource": "observed",
"highVariance": true
},
"proportionalBps": {
"value": 123,
"routerFeeBps": 123,
"priceImpactBps": 123,
"extrapolated": true
},
"allInBps": {
"current": 123,
"p50_7d": 123,
"p90_7d": 123,
"floor": true
},
"missing": [
"swap_gas"
]
}
}
}{
"success": false,
"error": "Validation error",
"details": {}
}Route survival
The wedge, not the score. An agent about to move real money needs “can I get out at size, measured today” more than “is this good”. This is the same verdict refreshAllRouteScreens writes daily and the live engine uses to gate deposits — exposed read-only. Round trip, on the protocol’s own execution path, so no pricing oracle is involved: USDC compared against USDC.
A vault that has never been screened returns screened: false with every measurement field null — never a fabricated verdict.
curl --request GET \
--url https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route \
--header 'x-api-key: <api-key>'import requests
url = "https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.atlasyield.club/v1/vaults/{chainId}/{address}/route")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"disclaimer": "Research and information, not investment advice.",
"data": {
"vaultId": "pendle:1:0x5949c3bfdf9babd8bf011d9d8dbb1a2c3e10d8b8",
"chainId": 1,
"screened": true,
"verdict": "OK",
"reasonClass": "protocol_refused",
"usdIn": 5000,
"usdOut": 4991,
"retained": 0.9982,
"path": "pendle",
"probe": {
"scope": "same-chain",
"funding": "<string>",
"legs": "<string>",
"notionalsUsd": [
100,
5000
],
"router": {},
"crossChain": "not probed"
},
"checkedAt": "2023-11-07T05:31:56Z",
"cost": {
"notionalUsd": 10000,
"router": "lifi",
"gasBasis": "p50_7d",
"fixedUsd": {
"current": 123,
"p50_7d": 123,
"p90_7d": 123,
"floor": true
},
"gasUnits": {
"swap": 123,
"vaultEntry": 123,
"vaultExit": 123,
"approvals": 123,
"total": 123,
"vaultGasSource": "observed",
"highVariance": true
},
"proportionalBps": {
"value": 123,
"routerFeeBps": 123,
"priceImpactBps": 123,
"extrapolated": true
},
"allInBps": {
"current": 123,
"p50_7d": 123,
"p90_7d": 123,
"floor": true
},
"missing": [
"swap_gas"
]
}
}
}{
"success": false,
"error": "Validation error",
"details": {}
}Authorizations
Optional. Not needed for any endpoint in this spec. Unlocks the partner-only endpoints and a 100 requests per minute bucket (public limit is 60 per IP).
Path Parameters
EVM chain id the vault lives on.
Vault contract address. Case-insensitive.
Query Parameters
USD size to cost the round trip at. 10 to 10,000,000, default 5,000.
10 <= x <= 10000000Response
The most recent route-survival verdict for the vault, or the unscreened shape.
true
"Research and information, not investment advice."
Round-trip route-survival verdict for one vault: send USDC in, take the position, sell it straight back, on the exact path the app itself executes. "Can I get out at size, measured today" — not a liquidity claim, a real quote. SAME-CHAIN ONLY: funding USDC sits on the vault's own chain. Nothing here describes bridging in from another chain (see probe).
Show child attributes
Show child attributes