Docs

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

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:

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.

  1. Click the API in your catalog
  2. Click Generate SDK
  3. Choose your language: Python, TypeScript, Go, Rust, Kotlin
  4. 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:

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

StatusMeaningFix
401Bad auth tokenCheck your token in Settings
402Insufficient USDCTop up your wallet
404API not foundCheck the API name
502Owner's API errorTry again later
504Owner unreachableAPI server is down