Get allowance by owner, spender, token, and block number for a given network.
GET/:network/allowance/single
Get allowance by owner, spender, token, and block number for a given network.
Request
Path Parameters
Blockchain network name or chain id
Query Parameters
The wallet address or ENS name of the owner.
The wallet address or ENS name of the spender.
The contract address of the token.
Optional block number for which the balance is requested. Provide only block height or timestamp you want to check for.
Optional Date timestamp for which the balance is requested (ISO 8601 format). Provide only block height or timestamp you want to check for.
The id of your project. Can be found in your Histori dashboard.
Responses
- 200
- 400
- 404
The allowance data.
- application/json
- Schema
- Example (from schema)
Schema
Blockchain network name For the requested query
The chain ID of the network.
The contract address of the token in hexadecimal format.
The name of the token.
The symbol of the token.
The ERC standard of the Token (erc20 or erc777)
The address of the owner.
The address of the spender.
The allowance amount of the token, as a string. The amount is in the smallest unit of the token.
The allowance amount of the token, as a string, denominated in ether
The block number for which the allowance is requested.
Timestamp for which the allowance is queried (ISO 8601 format).
{
"network_name": "eth-mainnet",
"chain_id": 1,
"token_address": "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84",
"token_name": "Liquid staked Ether 2.0",
"token_symbol": "stETH",
"token_type": "erc20",
"owner": "0xa24D38b1B49E32c1c63731810a8D42ec9dd9aa8C",
"spender": "0x858646372CC42E1A627fcE94aa7A7033e7CF075A",
"allowance": "115792089237316195423570985008687907853269984665640564039457584007913129639935",
"allowance_eth": "115792089237316195423570985008687907853269984665640564039457,584007913129639935",
"checked_at_block": 20853281,
"checked_at_date": "2024-10-17T09:03:59.000Z"
}
Invalid request parameters.
Historical Allowance does not exist for this owner and spender.