Rate Limit

Too many requests were made in a short period. The caller exceeded the allowed request rate and was throttled until the next time window.

Invalid Parameters

The request contained missing or incorrectly formatted values — for example, a malformed wallet address, an unsupported network name, or a required field left blank.

Not Found

The requested resource could not be located. Common causes: a wallet with no on-chain activity, a token that doesn't exist on the selected network, or a transaction hash not yet indexed.

Failed Authentication

The API key provided was invalid, expired, or missing. The request was rejected before reaching the tool. The caller should verify their key hasn't been revoked.

Failed Payment

An x402 micropayment was required to call this tool but was not completed. The caller's wallet may have insufficient USDC on Base, or the x402 payment client may not be configured.

Upstream Error

An external service OneSource depends on — such as a blockchain node or third-party data provider — returned an error or was temporarily unavailable.

Internal Error

An unexpected error occurred within OneSource. These are automatically logged and reviewed by the engineering team.