v1

Supported Networks: All networks on the main delegate.xyz website are supported

Rate Limits: 25 requests per 10 seconds

Delegations by wallet

Get a list of incoming and outgoing delegations for a specific wallet.

GET https://api.delegate.xyz/registry/v1/:wallet

Path Parameters

Name	Type	Description
wallet*	Address	The wallet to get delegations

Query Parameters

Name	Type	Description
chainId	number	Defaults to 1 (mainnet)

200: OK Delegation[]

type Delegation = {
    type: "NONE" | "ALL" | "CONTRACT" | "TOKEN";
    delegate: string;
    vault: string;
    contract: string | null;
    tokenId: number | null;
};

// returns Delegation[]

Delegations by wallet Example

curl https://api.delegate.xyz/registry/v1/0x0000000000000000000000000000000000000000

Delegation Checks

Returns true if the address is delegated to act on the entire vault

GET https://api.delegate.cash/registry/v1/check/all

Query Parameters

Name	Type	Description
delegate*	Address	The hot wallet to act on your behalf
vault*	Address	The cold wallet who issued the delegation
chainId	number	Defaults to 1 (mainnet)

200: OK Boolean

Check All Example

curl https://api.delegate.xyz/registry/v1/check/all?delegate=0x0000000000000000000000000000000000000000&vault=0x0000000000000000000000000000000000000001

Returns true if the address is delegated to act on your behalf for a token contract or an entire vault

GET https://api.delegate.cash/registry/v1/check/contract

Query Parameters

Name	Type	Description
delegate*	Address	The hot wallet to act on your behalf
vault*	Address	The cold wallet who issued the delegation
contract*	Address	The address for the contract you're delegating
chainId	number	Defaults to 1 (mainnet)

200: OK Boolean

Check Contract Example

curl https://api.delegate.xyz/registry/v1/check/contract?delegate=0x0000000000000000000000000000000000000000&vault=0x0000000000000000000000000000000000000001&contract=0x0000000000000000000000000000000000000003

Returns true if the address is delegated to act on your behalf for a specific token, the token's contract or an entire vault

GET https://api.delegate.xyz/registry/v1/check/token

Query Parameters

Name	Type	Description
delegate*	Address	The hot wallet to act on your behalf
vault*	Address	The cold wallet who issued the delegation
contract*	Address	The address for the contract you're delegating
tokenId*	Number	The token id for the token you're delegating
chainId	number	Defaults to 1 (mainnet)

200: OK Boolean

Check Token Example

curl https://api.delegate.xyz/registry/v1/check/contract?delegate=0x0000000000000000000000000000000000000000&vault=0x0000000000000000000000000000000000000001&contract=0x0000000000000000000000000000000000000003&tokenId=1