Protocols API

List All Protocols

GET /protocols Retrieve a list of all supported DeFi protocols.

Request

curl "https://api.1tx.fi/api/v1/protocols"

Query Parameters

Parameter	Type	Required	Description
`chainId`	number	No	Filter by chain ID

Response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Aave",
    "version": 3,
    "displayName": "Aave V3",
    "chainId": 8453,
    "protocolAddress": "0x...",
    "icon": "aave",
    "docsUrl": "https://docs.aave.com",
    "deprecated": false,
    "deprecationReason": null,
    "createdAt": "2024-01-01T00:00:00Z",
    "updatedAt": "2024-01-15T14:30:00Z"
  },
  {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "name": "Compound",
    "version": 3,
    "displayName": "Compound V3",
    "chainId": 8453,
    "protocolAddress": "0x...",
    "icon": "compound",
    "docsUrl": "https://docs.compound.finance",
    "deprecated": false,
    "deprecationReason": null,
    "createdAt": "2024-01-01T00:00:00Z",
    "updatedAt": "2024-01-15T14:30:00Z"
  },
  {
    "id": "550e8400-e29b-41d4-a716-446655440002",
    "name": "Morpho",
    "version": 1,
    "displayName": "Morpho Blue",
    "chainId": 8453,
    "protocolAddress": "0x...",
    "icon": "morpho",
    "docsUrl": "https://docs.morpho.org",
    "deprecated": false,
    "deprecationReason": null,
    "createdAt": "2024-01-01T00:00:00Z",
    "updatedAt": "2024-01-15T14:30:00Z"
  }
]

Response Fields

Field	Type	Description
`id`	string	Unique protocol identifier (UUID)
`name`	string	Protocol name (Aave, Compound, Morpho, Euler, Fluid)
`version`	number	Protocol version number
`displayName`	string	Human-readable protocol name with version
`chainId`	number	Chain ID where this protocol is deployed
`protocolAddress`	string	Main protocol contract address
`icon`	string	Icon identifier for UI display
`docsUrl`	string	Link to protocol documentation
`deprecated`	boolean	Whether this protocol version is deprecated
`deprecationReason`	string	Reason for deprecation (if applicable)
`createdAt`	string	ISO 8601 creation timestamp
`updatedAt`	string	ISO 8601 last update timestamp

Get Single Protocol

GET /protocols/:id Retrieve details for a specific protocol.

Request

curl "https://api.1tx.fi/api/v1/protocols/550e8400-e29b-41d4-a716-446655440000"

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The protocol UUID

Response

The single protocol endpoint returns the protocol object plus its related instruments array.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Aave",
  "version": 3,
  "displayName": "Aave V3",
  "chainId": 8453,
  "protocolAddress": "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5",
  "icon": "aave",
  "docsUrl": "https://docs.aave.com",
  "deprecated": false,
  "deprecationReason": null,
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-15T14:30:00.000Z",
  "instruments": [
    {
      "instrumentId": "0x00002105c053a3e1290845e12a3eea14926472ce7f15da324cdf0700056fc04b",
      "chainId": 8453,
      "tokenSymbol": "USDC"
    }
  ]
}

Get Protocol by Name and Chain

GET /protocols/by-name/:name/chain/:chainId Retrieve all versions of a protocol on a specific chain.

Request

curl "https://api.1tx.fi/api/v1/protocols/by-name/Aave/chain/8453"

Path Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Protocol name (Aave, Compound, Morpho, Euler, Fluid)
`chainId`	number	Yes	Chain ID

Response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Aave",
    "version": 3,
    "displayName": "Aave V3",
    "chainId": 8453,
    "protocolAddress": "0x...",
    "icon": "aave",
    "docsUrl": "https://docs.aave.com",
    "deprecated": false,
    "deprecationReason": null,
    "createdAt": "2024-01-01T00:00:00Z",
    "updatedAt": "2024-01-15T14:30:00Z"
  }
]

Get Latest Protocol Version

GET /protocols/by-name/:name/chain/:chainId/latest Retrieve the latest version of a protocol on a specific chain.

Request

curl "https://api.1tx.fi/api/v1/protocols/by-name/Aave/chain/8453/latest"

Path Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Protocol name
`chainId`	number	Yes	Chain ID

Response

Returns a single protocol object with the same fields as an item in List All Protocols. Unlike GET /protocols/:id, this endpoint does not include the related instruments array.

TypeScript Example

const BASE_URL = 'https://api.1tx.fi/api/v1';

interface Protocol {
  id: string;
  name: string;
  version: number;
  displayName: string;
  chainId: number;
  protocolAddress: string;
  icon?: string;
  docsUrl?: string;
  deprecated: boolean;
  deprecationReason?: string;
  createdAt: string;
  updatedAt: string;
}

// Get all protocols
async function getProtocols(chainId?: number): Promise<Protocol[]> {
  const params = chainId ? `?chainId=${chainId}` : '';
  const response = await fetch(`${BASE_URL}/protocols${params}`);
  return response.json();
}

// Get protocol by ID
async function getProtocol(id: string): Promise<Protocol> {
  const response = await fetch(`${BASE_URL}/protocols/${id}`);
  return response.json();
}

// Get latest protocol version
async function getLatestProtocol(
  name: string,
  chainId: number
): Promise<Protocol> {
  const response = await fetch(
    `${BASE_URL}/protocols/by-name/${name}/chain/${chainId}/latest`
  );
  return response.json();
}

// Usage
const protocols = await getProtocols(8453);
console.log(`Found ${protocols.length} protocols on Base`);

protocols.forEach((p) => {
  console.log(`${p.displayName}: ${p.protocolAddress}`);
  if (p.deprecated) {
    console.log(`  ⚠️ Deprecated: ${p.deprecationReason}`);
  }
});

API Documentation

List All Protocols

Request

Query Parameters

Response

Response Fields

Get Single Protocol

Request

Path Parameters

Response

Get Protocol by Name and Chain

Request

Path Parameters

Response

Get Latest Protocol Version

Request

Path Parameters

Response

TypeScript Example

Next Steps

Instruments API

Chains API

​List All Protocols

​Request

​Query Parameters

​Response

​Response Fields

​Get Single Protocol

​Request

​Path Parameters

​Response

​Get Protocol by Name and Chain

​Request

​Path Parameters

​Response

​Get Latest Protocol Version

​Request

​Path Parameters

​Response

​TypeScript Example

​Next Steps

Instruments API

Chains API

List All Protocols

Request

Query Parameters

Response

Response Fields

Get Single Protocol

Request

Path Parameters

Response

Get Protocol by Name and Chain

Request

Path Parameters

Response

Get Latest Protocol Version

Request

Path Parameters

Response

TypeScript Example

Next Steps