API Keys & Integrator ID
How to get an API key and use it against the Across API.
What Are They?
| Credential | What it is | Where it's used |
|---|---|---|
| API Key | Authentication token for API requests | Authorization header on every Across API call |
| Integrator ID | Unique 2-byte hex identifier (e.g. 0xdead) | Deprecated APIs only — passed as an integratorId query parameter |
Latest Across API authenticates with the API key alone. There is no
integratorId parameter on any Across API endpoint. The integrator ID still
applies to the Deprecated APIs.
How to Request
Get your API key and Integrator ID — register your project and receive your credentials instantly.
Using with the Across API
Pass the key as a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEYconst BASE = "https://api.staging.across.to";
const res = await fetch(`${BASE}/v1/quotes`, {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.ACROSS_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
origin: {
token: { chainId: 42161, address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831" },
amount: "1000000",
depositor: "0xYourWalletAddress",
},
destination: {
token: { chainId: 8453, address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" },
recipient: "0xYourWalletAddress",
},
amountType: "exact_input",
fundingMethods: ["permit2"],
}),
});