Tutorial: Use APIs from the Marketplace
Find an API, test it for free, wire it into your app, and pay only for what you use.
What you need
- Docker installed and running
- 5 minutes to set up the control center
- A small amount of USDC for API calls (and a tiny bit of ETH for fees)
If you just want to browse and try demos, you do not even need USDC. Demo mode is completely free.
Step 0: Install the control center
Install and start the control center via Docker (see Installation). Open the web console and create your account.
Fund your wallet
Go to the Finance tab. Your deposit address is shown on the page. Send funds to it:
- USDC — this is what you pay for API calls. $10 gets you thousands of calls for most APIs.
- ETH — a small amount for transaction fees. $2-5 lasts a long time.
Both can be sent from any exchange (Coinbase, Kraken, etc.) or another wallet.
Step 1: Browse the catalog
In the web console, click the Catalog tab. You will see every API available on the marketplace.
Each listing shows the name, description, price per call, protocol, and live/offline status. Use the search bar to filter by keyword.
Step 2: Try before you buy (demo mode)
Every API comes with free demo samples. Click an API, then click Try Demo.
Demo mode returns real data captured by the API owner when they registered. It shows you the response format, fields, and data types — all for free.
Select the API first. Click Select on any API to add it to your My APIs list. All new APIs start in demo mode by default.
Step 3: Generate an SDK
Every API includes an OpenAPI specification. Your control center uses it to generate a ready-to-use client library.
- Click the API in your catalog
- Click Generate SDK
- Choose your language: Python, TypeScript, Go, Rust, Kotlin
- Download and drop it into your project
The SDK handles authentication and request formatting. You just call methods. See SDKs for code examples.
Step 4: Make real API calls
When you are ready to use live data, switch the API from demo to production mode in My APIs (flip the toggle from "Demo" to "On").
Now every call returns live data. You are charged the per-call price automatically from your USDC balance.
Using the SDK
If you generated an SDK, nothing changes in your code. The same methods that returned demo data now return live data.
Using the Swagger panel
Each API in the catalog has an interactive Swagger panel where you can test individual endpoints with custom parameters directly in the web console.
Step 5: Monitor spending
The Dashboard in your web console tracks everything:
- Total calls made — today, this week, all time
- Total spent in USDC, with per-API breakdown
- Balance remaining
- Projected runway — how many days your balance will last
Set up email alerts for low balance so you never run out mid-operation.
Tips from experience
Start with demo mode
Always try the demo first. Check that the data format matches what you need before spending USDC.
Fund small, top up later
Start with $10-20 of USDC. See how many calls your app actually makes, then fund accordingly.
Use the Swagger sandbox
Each API has an interactive Swagger panel in the web console. Use it to explore endpoints before writing code.
Check the status indicator
Before relying on an API, check its status in the catalog. A green "Live" badge means it is available.
Common errors
| Status | Meaning | Fix |
|---|---|---|
401 | Bad auth token | Check your token in Settings |
402 | Insufficient USDC | Top up your wallet |
404 | API not found | Check the API name |
502 | Owner's API error | Try again later |
504 | Owner unreachable | API server is down |