API Introduction

Overview

The Giza API is the HTTP layer behind the SDK. It gives direct access to all agent services.

For most use cases, the TypeScript SDK is easier — it gives you type safety, automatic authentication, and structured error handling. Use the HTTP API directly when:

Building in a language without SDK support
Needing lower-level control
Integrating with existing HTTP infrastructure

Base URL

https://partners-backend-1038109371738.europe-west1.run.app

API Groups

Agents

Core agent operations: activation, monitoring, withdrawals

Protocols

DeFi protocol information and availability

Optimizer

Capital allocation optimization

Statistics

Platform-wide statistics and TVL

Rewards

Reward staking status and history

Support

Supported chains and tokens

Common Parameters

Chain ID

Most endpoints require a chain_id path parameter:

Chain	ID
Base	`8453`
Ethereum	`1`
Arbitrum	`42161`
Polygon	`137`
Base Sepolia	`84532`
Sepolia	`11155111`

Wallet Address

Wallet addresses must be valid Ethereum addresses:

Start with 0x
42 characters total (0x + 40 hex characters)
Case-insensitive

Response Format

All successful responses return JSON with the following structure:

{
  "data": { ... }
}

Error responses follow this format:

{
  "detail": [
    {
      "loc": ["path", "wallet"],
      "msg": "Invalid wallet address",
      "type": "value_error"
    }
  ]
}

HTTP Status Codes

Code	Description
`200`	Success
`201`	Created
`204`	No Content (success with no response body)
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid API key
`403`	Forbidden - Access denied
`404`	Not Found - Resource doesn’t exist
`422`	Validation Error - Invalid input
`500`	Internal Server Error
`503`	Service Unavailable

Rate Limits

API requests are rate-limited per partner. If you exceed limits, you’ll receive a 429 Too Many Requests response.

Contact Giza to discuss rate limit increases for production use cases.

OpenAPI Specification

The complete API specification is available in OpenAPI 3.1 format:

https://partners-backend-1038109371738.europe-west1.run.app/api/v1/openapi.json

You can use this to:

Generate client libraries
Import into Postman
Validate requests

Interactive API Explorer

Swagger UI

Try API endpoints directly in the interactive Swagger documentation

Next Steps

Authentication

Learn how to authenticate API requests

Create Smart Account

Create a smart account for your user

SDK Reference

Use the TypeScript SDK instead

Quickstart

Complete integration guide

​Overview

​Base URL

​API Groups

Agents

Protocols

Optimizer

Statistics

Rewards

Support

​Common Parameters

​Chain ID

​Wallet Address

​Response Format

​HTTP Status Codes

​Rate Limits

​OpenAPI Specification

​Interactive API Explorer

Swagger UI

​Next Steps

Authentication

Create Smart Account

SDK Reference

Quickstart

Overview

Base URL

API Groups

Common Parameters

Chain ID

Wallet Address

Response Format

HTTP Status Codes

Rate Limits

OpenAPI Specification

Interactive API Explorer

Next Steps