Flash ProtocolFLASH PROTOCOL
DOCUMENTATION

Chains & Tokens

Query supported chains and tokens.

List Chains

Retrieve all supported blockchain networks. Results are cached and refreshed every 5 minutes.

GET/api/v1/chains

Query Parameters

Parameter
Required
Description
type
No
Filter by type: "all" (default), "evm", "solana".
hasUSDC
No
Set to "true" to only return chains with USDC support.
curl -X GET "https://flash-protocol.vercel.app/api/v1/chains?type=evm" \
  -H "Authorization: Bearer pg_live_..."
200 OK
{
  "data": [
    {
      "key": "8453",
      "chainId": 8453,
      "name": "Base",
      "type": "evm",
      "symbol": "ETH",
      "logoUrl": "https://...",
      "providers": { "lifi": true, "rango": true }
    },
    {
      "key": "137",
      "chainId": 137,
      "name": "Polygon",
      "type": "evm",
      "symbol": "POL",
      "logoUrl": "https://...",
      "providers": { "lifi": true, "rango": true, "symbiosis": true }
    }
  ],
  "total": 2
}

List Tokens

Retrieve supported tokens for a specific chain. Results are cached and include spam filtering.

GET/api/v1/tokens

Query Parameters

Parameter
Required
Description
chainKey
Yes
Chain key (e.g. "8453", "137", "solana").
curl -X GET "https://flash-protocol.vercel.app/api/v1/tokens?chainKey=8453" \
  -H "Authorization: Bearer pg_live_..."
200 OK
{
  "data": [
    {
      "address": "0x0000000000000000000000000000000000000000",
      "symbol": "ETH",
      "name": "Ethereum",
      "decimals": 18,
      "logoUrl": "https://...",
      "isNative": true,
      "chainKey": "8453"
    },
    {
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "logoUrl": "https://...",
      "isNative": false,
      "chainKey": "8453"
    }
  ],
  "chainKey": "8453",
  "total": 2
}

Error Responses

Status
Code
Description
400
Bad Request
Missing required chainKey parameter (tokens endpoint).
401
Unauthorized
Invalid or missing API key.