# Ichiba

Ichiba is a marketplace for buying and selling internet infrastructure — compute instances, block storage, and networking resources across every major cloud provider.

## What Ichiba does

Ichiba lets buyers search and purchase infrastructure resources from sellers using a unified API. Sellers list their cloud resources (AWS, GCP, Azure, Hetzner, DigitalOcean, and more) and set prices. Buyers search with natural language queries and purchase with a single API call. When a purchase is made, the seller's gateway automatically provisions the resource.

## API base URL

https://api.ichiba.tech

All endpoints return JSON and require Bearer token authentication.

## Authentication

Generate a Bearer token from your organization's API Tokens section at https://app.ichiba.tech.

Include in every request:
  Authorization: Bearer ichiba_...

## Key endpoints

### Search listings (natural language)
POST /api/listings/search
Body: { "query": "8 ARM64 vCPUs, 32 GB RAM, under $2/hour" }
Returns: ranked listings with per-listing highlights, summary, and full specs.

### Browse all active listings
GET /api/listings/active
Returns all active listings across every seller with full specs.

### Purchase a listing
POST /api/listings/:listing_id/purchase
Provisions the resource from the seller's gateway. Returns a purchase ID. Poll GET /api/purchases/:id to check status.

### List your purchases
GET /api/purchases
Returns all purchases for the authenticated organization. Filter by status: pending, active, cancelled, failed.

### Cancel a purchase
DELETE /api/purchases/:id
Deprovisions the resource and cancels the purchase.

### Manage your own listings
GET    /api/listings          — list your organization's listings
POST   /api/listings          — create a listing
PUT    /api/listings/:id      — update a listing
DELETE /api/listings/:id      — delete a listing

## Asset types

- compute — virtual machines / instances, with vCPUs, memory, architecture, GPU, storage, and network specs
- block_storage — persistent volumes, with capacity, IOPS, throughput, storage class, and redundancy

## Full API reference

https://ichiba.tech/api/